UIElement.DesiredSize Propriété

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Obtient la taille calculée par ce UIElement pendant la passe de mesure du processus de disposition.

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

Size DesiredSize();

public Size DesiredSize { get; }

var size = uIElement.desiredSize;

Public ReadOnly Property DesiredSize As Size

Valeur de propriété

Size

Taille calculée par ce UIElement pendant la passe de mesure du processus de disposition.

Exemples

Cet exemple interroge DesiredSize dans le cadre de l’itération enfant pour une implémentation 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

Remarques

DesiredSize est généralement vérifié comme l’un des facteurs de mesure lorsque vous implémentez des remplacements de comportement de disposition tels que ArrangeOverride ou MeasureOverride. Selon la logique de disposition du conteneur parent, DesiredSize peut être entièrement respecté, des contraintes sur DesiredSize peuvent être appliquées et ces contraintes peuvent également modifier d’autres caractéristiques de l’élément parent ou de l’élément enfant. Par exemple, un contrôle qui prend en charge les régions pouvant faire défiler (mais choisit de ne pas dériver des contrôles qui activent déjà les régions pouvant faire défiler) peut comparer la taille disponible à DesiredSize. Le contrôle peut ensuite définir un état interne qui active les barres de défilement dans l’interface utilisateur pour ce contrôle. Ou bien, DesiredSize peut être ignoré et l’élément obtient toujours une disposition qui est dimensionnée en fonction d’autres considérations, telles que la vérification des valeurs de propriété jointes.

DesiredSize ne contient pas de valeur utile, sauf si au moins une passe de disposition « Measure » a été exécutée sur l’élément.

DesiredSize est uniquement destiné à être utilisé lorsque vous définissez vos propres méthodes de remplacement de disposition. Si la taille d’un élément de l’interface utilisateur de votre application au moment de l’exécution vous intéresse, vous devez utiliser les propriétés ActualWidth et ActualHeight à la place. Vous pouvez vérifier la taille de cette façon si un élément est influencé par des techniques de disposition dynamiques telles que star dimensionnement des cellules Grid. Appuyez-vous sur les valeurs ActualWidth et ActualHeight uniquement dans les situations qui sont sûrs d’être après l’exécution de la disposition : par exemple, dans les événements chargés ou déclenchées par des actions utilisateur qui ne sont possibles qu’après le rendu initial de l’interface utilisateur.

S’applique à

Produit	Versions
WinRT	Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Voir aussi

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

Partager via