FrameworkElement.ArrangeOverride(Size) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供配置「排列」階段的行為。 類別可以覆寫這個方法，以定義自己的「排列」傳遞行為。
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
父系內最後一個區域，這個物件應該用來排列本身及其子系。
傳回
在配置中排列元素之後所使用的實際大小。
範例
此範例會實作 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);
}
'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 會提供 Arrange的行為，每當由內部配置邏輯或您自己的應用程式程式碼呼叫 Arrange 時，包括您自己針對其他類別使用的任何 ArrangeOverride 方法。 如果您要產生樣板化控制項，ArrangeOverride 邏輯會定義控制項的特定「排列」傳遞配置邏輯。
當您的應用程式執行時，元素如何經歷版面配置程式的一般設計分成兩個步驟：「量值」階段，然後是「排列」階段。 控制項作者 (或面板作者) 想要自訂版面配置處理的「排列」階段，應該覆寫 ArrangeOverride。 實作模式應該在每個可見的子物件上呼叫 Arrange ，並將每個子物件的最終所需大小傳遞為 finalRect 參數。 如果未呼叫 Arrange ，則不會轉譯子物件。
數個現有的非密封類別提供此方法的覆寫實作。 醒目顯示的專案包括 StackPanel 和 Grid。 一般而言，ArrangeOverride 的行為會產生 finalSize ，不會違反任何放置在配置容器本身的使用者定義值。 例如， finalSize 通常不會大於容器 的 Height 和 Width，會考慮影響內容區域的 Margin 或 Padding 值。 特別具有超過容器大小的案例的控制項可能會傳回較大的值，但使用該控制項的任何人，都必須考慮其所產生的裁剪和定位問題。 ArrangeOverride 實作針對每個子物件傳遞至Arrange的值，通常是先前Measure呼叫在DesiredSize中設定的值。