UIElement.DesiredSize Eigenschaft

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

Size DesiredSize();

public Size DesiredSize { get; }

var size = uIElement.desiredSize;

Public ReadOnly Property DesiredSize As Size

Eigenschaftswert

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

Beispiele

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

// 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);
}

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 werden DesiredSize möglicherweise vollständig berücksichtigt, Einschränkungen für DesiredSize angewendet, und solche Einschränkungen können auch andere Merkmale des übergeordneten Elements oder untergeordneten Elements ändern. Beispielsweise könnte ein Steuerelement, das Bildlaufbereiche unterstützt (jedoch nicht aus den Steuerelementen abgeleitet werden soll, die bereits Bildlaufbereiche aktivieren) die verfügbare Größe mit DesiredSize vergleichen. Das Steuerelement kann dann einen internen Zustand festlegen, der Bildlaufleisten in der Benutzeroberfläche für dieses Steuerelement aktiviert hat. Oder DesiredSize könnte ignoriert werden, und das Element erhält immer ein Layout, das durch andere Aspekte wie das Überprüfen angefügter Eigenschaftswerte angepasst wird.

DesiredSize enthält keinen nützlichen Wert, es sei denn, mindestens ein "Measure"-Pass des Layouts wird für das Element ausgeführt.

DesiredSize ist wirklich nur für die Verwendung vorgesehen, wenn Sie Eigene Layoutüberschreibungsmethoden definieren. Wenn Sie nur an der Größe eines Elements in 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 die Größenanpassung von Rasterzellen beeinflusst wird. Verlassen Sie sich nur auf ActualWidth - und ActualHeight-Werte in Situationen, die sicher sind, nachdem das Layout ausgeführt wurde: z. B. in geladenen Ereignissen oder durch Benutzeraktionen ausgelöst, die nur möglich sind, nachdem die Benutzeroberfläche anfänglich gerendert wurde.

Weitere Informationen

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