MSDN Library
信息
您所需的主题如下所示。但此主题未包含在此库中。

FrameworkElement.ArrangeOverride 方法

2013/12/13

提供 Windows Phone 布局的排列处理过程的行为。 类可以重写该方法来定义其自己的排列处理过程行为。

Namespace:  System.Windows
程序集:  System.Windows(位于 System.Windows.dll 中)

声明
Protected Overridable Function ArrangeOverride ( _
	finalSize As Size _
) As Size

参数

finalSize
类型: System.Windows.Size
父级中此对象应用来排列自身及其子元素的最终区域。

返回值

类型: System.Windows.Size
元素在布局中排列后使用的实际大小。

此方法具有可为多数 Windows Phone FrameworkElement 派生类执行内置布局的默认实现。

每次通过内部布局逻辑或应用程序代码调用该方法时,ArrangeOverride 有效地提供 Arrange 的其他实现。 如果您正在生成可发布的内容控件,ArrangeOverride 逻辑定义了您的控件的特定“排列”的处理过程布局逻辑。

对继承者的说明

对于 Windows Phone,在布局中调整元素大小和定位元素的方法可分为两个步骤: 测量处理过程,然后排列处理过程。 主题 Windows Phone 的布局中对此技术进行了更详细的说明。

要自定义布局处理的排列处理过程的控件作者(或面板作者)应重写 ArrangeOverride。 实现模式应在每个可见子对象上调用 Arrange,然后将每个子对象的最终所需大小作为 finalRect 参数进行传递。 包含可见子对象的容器应在每个子对象上调用 Arrange;否则,将不会呈现子对象。

一些现有的非密封 Windows Phone 类提供此方法的重写实现。 其中主要的类包括: StackPanel.ArrangeOverrideGrid.ArrangeOverride

通常,ArrangeOverride 的行为将生成不会违反放置在布局容器自身上的任何用户定义的值的 finalSize。 例如,考虑到影响内容区域的 MarginPadding 值,finalSize 通常不大于容器的 HeightWidth。 有专门应对超出容器大小的方案的控件能够返回更大的值,但必须要考虑到由这种行为导致的裁剪和定位问题。

ArrangeOverride 实现传递给每个子对象的 Arrange 的值通常是由该对象上的前一个度量处理过程在 DesiredSize 中设置的值。 但是,这可能会因容器启用的特定布局功能而异。

下面的示例实现了 ArrangeOverride,以便为自定义面板实现来自定义排列处理过程逻辑。 请特别注意代码的以下方面:

  • 遍历子级。

  • 对于每个子级,使用 Rect(其中 HeightWidth 基于 DesiredSizeXY 基于特定于面板的逻辑)调用 Arrange

  • 返回其大小(在此情况下,此简单面板返回固定大小而不是通过累计排列的 Rect 值度量计算的大小)。


'Second arrange all children and return final size of panel 
Protected Overloads Overrides Function ArrangeOverride(ByVal finalSize As Size) As Size
    'Get the collection of children 
    Dim mychildren As UIElementCollection = Children

    'Get total number of children 
    Dim count As Integer = mychildren.Count

    'Arrange children 
    'We're only allowing 9 children in this panel. More children will get a 0x0 layout slot. 
    Dim i As Integer
    For i = 0 To 8

        'Get (left, top) origin point for the element in the 3x3 block 
        Dim cellOrigin As Point = GetOrigin(i, 3, New Size(100, 100))

        'Arrange child 
        'Get desired height and width. This will not be larger than 100x100 as set in MeasureOverride. 
        Dim dw As Double = mychildren(i).DesiredSize.Width
        Dim dh As Double = mychildren(i).DesiredSize.Height


        mychildren(i).Arrange(New Rect(cellOrigin.X, cellOrigin.Y, dw, dh))
    Next
    For i = 9 To count - 1

        'Give the remaining children a 0x0 layout slot 
        mychildren(i).Arrange(New Rect(0, 0, 0, 0))
    Next


    'Return final size of the panel 
    Return New Size(300, 300)
End Function

'Calculate point origin of the Block you are in 
Protected Function GetOrigin(ByVal blockNum As Integer, ByVal blocksPerRow As Integer, ByVal itemSize As Size) As Point
    'Get row number (zero-based) 
    Dim row As Integer = CInt(Math.Floor(blockNum / blocksPerRow))

    'Get column number (zero-based) 
    Dim column As Integer = blockNum - blocksPerRow * row

    'Calculate origin 
    Dim origin As New Point(itemSize.Width * column, itemSize.Height * row)
    Return origin

End Function


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2016 Microsoft