UIElement.DesiredSize Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Ottiene le dimensioni calcolate da 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

Questo esempio esegue una query 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);
}

'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

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 aree scorrevoli (ma sceglie di non derivare dai controlli che già abilitano 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".

DesiredSize è destinato all'uso solo quando si definiscono metodi di override del layout personalizzati. Se sei interessato solo 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 star ridimensionamento delle celle griglia. Si basano sui valori ActualWidth e ActualHeight solo nelle situazioni in cui il layout è stato eseguito: ad esempio, negli eventi Loaded o attivati da azioni utente che sono possibili solo dopo il rendering iniziale dell'interfaccia utente.

Vedi anche

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