UIElement.DesiredSize Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Ottiene le dimensioni calcolate da questo UIElement durante il passaggio della misura del processo di layout.

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à

Size

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

Esempio

In questo esempio si esegue una query DesiredSize come parte dell'iterazione figlio per un'implementazione di 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 gli overridi del comportamento del layout, ad esempio ArrangeOverride o MeasureOverride. A seconda della logica di layout del contenitore padre, DesiredSize potrebbe essere completamente rispettato, i vincoli su DesiredSize potrebbero essere applicati e tali vincoli potrebbero anche modificare altre caratteristiche dell'elemento padre o dell'elemento figlio. Ad esempio, un controllo che supporta aree scorrevoli (ma sceglie di non derivare dai controlli che già abilitano aree scorrevoli) potrebbe confrontare le dimensioni disponibili in 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 contiene un valore utile a meno che non sia stato eseguito almeno un passaggio di layout "Measure".

DesiredSize è davvero destinato all'uso solo quando si definiscono i propri metodi di override del layout. Se si è interessati solo alle dimensioni di un elemento nell'interfaccia utente dell'app in fase di esecuzione, è consigliabile usare invece le proprietà ActualWidth e ActualHeight . È possibile controllare le dimensioni in questo modo se un elemento è influenzato da tecniche di layout dinamiche, ad esempio star ridimensionamento delle celle griglia. Si basano sui valori ActualWidth e ActualHeight solo in situazioni in cui il layout è stato eseguito: ad esempio, negli eventi caricati o attivati da azioni utente che sono possibili solo dopo il rendering iniziale dell'interfaccia utente.

Si applica a

Vedi anche