FrameworkElement.ArrangeOverride(Size) 方法

定義

命名空間:

Microsoft.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，以自訂自訂面板實作的「排列」傳遞邏輯。 請特別注意下列程式碼層面：

• 逐一查看子系。
• 針對每個子系，使用Rect呼叫Arrange，其中Height和Width是以DesiredSize為基礎，而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);
}

備註

這個方法具有預設實作，可針對大部分 FrameworkElement 衍生類別執行內建配置。 ArrangeOverride 會提供 Arrange的行為，每當由內部配置邏輯或您自己的應用程式程式碼呼叫 Arrange 時，包括您自己針對其他類別使用的任何 ArrangeOverride 方法。 如果您要產生樣板化控制項，ArrangeOverride 邏輯會定義控制項的特定「排列」傳遞配置邏輯。

當您的應用程式執行時，元素如何經歷版面配置程式的一般設計分成兩個步驟：「量值」階段，然後是「排列」階段。 控制項作者 (或面板作者) 想要自訂版面配置處理的「排列」階段，應該覆寫 ArrangeOverride。 實作模式應該在每個可見的子物件上呼叫 Arrange ，並將每個子物件的最終所需大小傳遞為 finalRect 參數。 如果未呼叫 Arrange ，則不會轉譯子物件。

數個現有的非密封類別提供此方法的覆寫實作。 醒目顯示的專案包括 StackPanel 和 Grid。 一般而言，ArrangeOverride 的行為會產生 finalSize ，不會違反任何放置在配置容器本身的使用者定義值。 例如， finalSize 通常不會大於容器 的 Height 和 Width，會考慮影響內容區域的 Margin 或 Padding 值。 特別具有超過容器大小的案例的控制項可能會傳回較大的值，但使用該控制項的任何人，都必須考慮其所產生的裁剪和定位問題。 ArrangeOverride 實作針對每個子物件傳遞至Arrange的值，通常是先前Measure呼叫在DesiredSize中設定的值。

另請參閱

• Arrange(Rect)
• MeasureOverride(Size)
• 使用 XAML 定義版面配置