FrameworkElement.ArrangeOverride(Size) メソッド

定義

名前空間:

Windows.UI.Xaml

レイアウトの "配置" パスの動作を提供します。 クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。

protected:
 virtual Size ArrangeOverride(Size finalSize) = ArrangeOverride;

Size ArrangeOverride(Size const& finalSize);

protected virtual Size ArrangeOverride(Size finalSize);

function arrangeOverride(finalSize)

Protected Overridable Function ArrangeOverride (finalSize As Size) As Size

パラメーター

finalSize

Size

このオブジェクトが自身とその子を配置するために使用する親内の最後の領域。

戻り値

Size

要素がレイアウトに配置された後に使用される実際のサイズ。

例

この例では、ArrangeOverride を実装して、カスタム パネル実装の "配置" パス ロジックをカスタマイズします。 特に、コードの次の側面に注意してください。

• 子を反復処理します。
• 各子について、Height と Width が DesiredSize に基づく Rect を使用して Arrange を呼び出し、X と Y はパネルに固有のロジックに基づいています。
• そのサイズを返します (この単純なパネルは、配置された Rect 値の測定値を累積して計算されたサイズではなく、固定サイズを返します)。

// Second arrange all children and return final size of panel
protected override Size ArrangeOverride(Size finalSize)
{
    // Get the collection of children
    UIElementCollection mychildren = Children;

    // Get total number of children
    int count = mychildren.Count;

    // Arrange children
    // We're only allowing 9 children in this panel.  More children will get a 0x0 layout slot.
    int i;
    for (i = 0; i < 9; i++)
    {

        // Get (left, top) origin point for the element in the 3x3 block
        Point cellOrigin = 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.
        double dw = mychildren[i].DesiredSize.Width;
        double dh = mychildren[i].DesiredSize.Height;

        mychildren[i].Arrange(new Rect(cellOrigin.X, cellOrigin.Y, dw, dh));

    }

    // Give the remaining children a 0x0 layout slot
    for (i = 9; i < count; i++)
    {
        mychildren[i].Arrange(new Rect(0, 0, 0, 0));
    }


    // Return final size of the panel
    return new Size(300, 300);
}

'Second arrange all children and return final size of panel 
Protected 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 
    '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

注釈

このメソッドには、ほとんどの FrameworkElement 派生クラスの組み込みレイアウトを実行する既定の実装があります。 ArrangeOverride は、 内部レイアウト ロジックまたは独自のアプリのコード (他のクラス用に独自の ArrangeOverride メソッドを含む) によって Arrange が呼び出されるたびに、Arrange の動作を提供します。 テンプレート化されたコントロールを生成する場合、ArrangeOverride ロジックによって、コントロールの特定の "配置" パス レイアウト ロジックが定義されます。

アプリの実行時に要素がレイアウト プロセスを通過する方法の一般的な設計は、"Measure" パスと "Arrange" パスの 2 つの手順に分かれています。 レイアウト処理の "配置" パスをカスタマイズするコントロール作成者 (またはパネル作成者) は、ArrangeOverride をオーバーライドする必要があります。 実装パターンでは、表示されている各子オブジェクトに対して Arrange を呼び出し、各子オブジェクトの最終的な目的のサイズを finalRect パラメーターとして渡す必要があります。 Arrange が呼び出されない場合、子オブジェクトはレンダリングされません。

いくつかの既存の非シール クラスは、このメソッドのオーバーライド実装を提供します。 目立つものには 、StackPanel と Grid があります。 通常、ArrangeOverride の動作では、レイアウト コンテナー自体に配置されているユーザー定義値に違反しない finalSize が生成されます。 たとえば、 finalSize は通常、コンテナーの Height と Width よりも大きくなく、コンテンツ領域に影響を与える Margin 値または Padding 値を考慮します。 特にコンテナー サイズを超えるシナリオを持つコントロールは、より大きな値を返す可能性がありますが、そのコントロールを使用するユーザーは、その結果生じるクリッピングと配置の問題を考慮する必要があります。 ArrangeOverride 実装が各子オブジェクトの Arrange に渡す値は、通常、前の Measure 呼び出しによって DesiredSize に設定される値です。

こちらもご覧ください

• Arrange(Rect)
• MeasureOverride(Size)
• XAML を使ったレイアウトの定義