UIElement.DesiredSize Proprietà

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

Size DesiredSize();

public Size DesiredSize { get; }

var size = uIElement.desiredSize;

Public ReadOnly Property DesiredSize As Size

Valore della proprietà

Dimensioni calcolate da questo UIElement durante il passaggio della misura del processo di layout.

Esempio

Questo esempio esegue una query su DesiredSize come parte dell'iterazione figlio per un'implementazione ArrangeOverride .

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

Commenti

DesiredSize viene in genere controllato come uno dei fattori di misurazione quando si implementano override del comportamento del layout, ad esempio ArrangeOverride o MeasureOverride. A seconda della logica di layout del contenitore padre, DesiredSize potrebbe essere completamente rispettato, potrebbero essere applicati vincoli su DesiredSize e tali vincoli potrebbero anche modificare altre caratteristiche dell'elemento padre o dell'elemento figlio. Ad esempio, un controllo che supporta le aree scorrevoli (ma sceglie di non derivare dai controlli che abilitano già le aree scorrevoli) potrebbe confrontare le dimensioni disponibili con DesiredSize. Il controllo potrebbe quindi impostare uno stato interno che abilitava le barre di scorrimento nell'interfaccia utente per tale controllo. In alternativa, DesiredSize può essere ignorato e l'elemento ottiene sempre un layout ridimensionato da altre considerazioni, ad esempio il controllo dei valori delle proprietà associate.

DesiredSize non conterrà un valore utile, a meno che non sia stato eseguito almeno un passaggio di layout "Measure" sull'elemento.

DesiredSize è destinato solo all'uso quando si definiscono metodi di override del layout personalizzati. Se sei interessato alle dimensioni di un elemento nell'interfaccia utente dell'app in fase di esecuzione, devi usare invece le proprietà ActualWidth e ActualHeight . È possibile controllare le dimensioni in questo modo se un elemento è influenzato da tecniche di layout dinamico, ad esempio il ridimensionamento delle stelle delle celle grid . Si basano sui valori ActualWidth e ActualHeight solo nelle situazioni in cui il layout è stato eseguito, ad esempio negli eventi Loaded o attivati dalle azioni utente che sono possibili solo dopo il rendering iniziale dell'interfaccia utente.

Vedi anche

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