UIElement.DesiredSize Eigenschaft

Definition

Namespace:

Windows.UI.Xaml

Ruft die Größe ab, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat.

public:
 property Size DesiredSize { Size get(); };

Size DesiredSize();

public Size DesiredSize { get; }

var size = uIElement.desiredSize;

Public ReadOnly Property DesiredSize As Size

Eigenschaftswert

Size

Die Größe, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat.

Beispiele

In diesem Beispiel wird DesiredSize als Teil der untergeordneten Iteration für eine ArrangeOverride-Implementierung abfragt.

// 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

Hinweise

DesiredSize wird in der Regel als einer der Messfaktoren überprüft, wenn Sie Layoutverhaltensüberschreibungen wie ArrangeOverride oder MeasureOverride implementieren. Abhängig von der Layoutlogik des übergeordneten Containers wird DesiredSize möglicherweise vollständig beachtet, Einschränkungen für DesiredSize können angewendet werden, und solche Einschränkungen können auch andere Merkmale des übergeordneten elements oder des untergeordneten Elements ändern. Beispielsweise kann ein Steuerelement, das scrollbare Regionen unterstützt (aber nicht von steuerelementen, die bereits scrollbare Regionen aktivieren) die verfügbare Größe mit DesiredSize vergleichen. Das Steuerelement könnte dann einen internen Zustand festlegen, der Bildlaufleisten auf der Benutzeroberfläche für dieses Steuerelement aktiviert hat. Oder DesiredSize könnte ignoriert werden, und das Element erhält immer ein Layout, das nach anderen Überlegungen wie dem Überprüfen angefügter Eigenschaftswerte dimensioniert ist.

DesiredSize enthält keinen nützlichen Wert, es sei denn, mindestens ein Measure-Layoutlauf wurde für das Element ausgeführt.

DesiredSize ist wirklich nur für die Verwendung vorgesehen, wenn Sie Ihre eigenen Layout-Außerkraftsetzungsmethoden definieren. Wenn Sie nur an der Größe eines Elements auf der Benutzeroberfläche Ihrer App zur Laufzeit interessiert sind, sollten Sie stattdessen die Eigenschaften ActualWidth und ActualHeight verwenden. Möglicherweise überprüfen Sie die Größe auf diese Weise, wenn ein Element durch dynamische Layouttechniken wie star Größenanpassung von Rasterzellen beeinflusst wird. Verlassen Sie sich auf ActualWidth - und ActualHeight-Werte nur in Situationen, die sicher sind, dass das Layout ausgeführt wurde: z. B . in geladenen Ereignissen oder ausgelöst durch Benutzeraktionen, die nur möglich sind, nachdem die Benutzeroberfläche ursprünglich gerendert wurde.

Weitere Informationen

• ArrangeOverride(Size)
• MeasureOverride(Size)
• Arrange(Rect)
• <xref:Windows.UI.Xaml.UIElement.Measure(Windows.Foundation.Size)%0a>
• Measure(Size)