UIElement.DesiredSize Свойство

Определение

Пространство имен:

Windows.UI.Xaml

Возвращает размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета.

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

Size DesiredSize();

public Size DesiredSize { get; }

var size = uIElement.desiredSize;

Public ReadOnly Property DesiredSize As Size

Значение свойства

Size

Размер, вычисленный этим элементом UIElement во время прохождения меры процесса макета.

Примеры

В этом примере выполняется запрос DesiredSize в рамках дочерней итерации для реализации 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

Комментарии

DesiredSize обычно проверяется как один из факторов измерения при реализации переопределений поведения макета, таких как ArrangeOverride или MeasureOverride. В зависимости от логики макета родительского контейнера, DesiredSize может полностью соблюдаться, могут применяться ограничения DesiredSize, и такие ограничения также могут изменять другие характеристики родительского или дочернего элемента. Например, элемент управления, поддерживающий прокручиваемые области (но не наследующий от элементов управления, которые уже поддерживают прокручиваемые области), может сравнить доступный размер с DesiredSize. Затем элемент управления может задать внутреннее состояние, включающее полосы прокрутки в пользовательском интерфейсе для этого элемента управления. Кроме того, desiredSize можно игнорировать, и элемент всегда получает макет, размер в соответствии с другими соображениями, такими как проверка значений присоединенных свойств.

DesiredSize не будет содержать полезное значение, если в элементе не выполнен по крайней мере один проход макета Measure.

DesiredSize действительно предназначен для использования только при определении собственных методов переопределения макета. Если вас интересует просто размер элемента в пользовательском интерфейсе приложения во время выполнения, следует использовать свойства ActualWidth и ActualHeight . Вы можете проверить размер таким образом, если на элемент влияют методы динамического макета, такие как star размер ячеек Сетки. Ищите значения ActualWidth и ActualHeight только в ситуациях, которые обязательно выполняются после выполнения макета: например, в событиях Загружены или активируются действиями пользователя, которые возможны только после первоначальной отрисовки пользовательского интерфейса.

См. также раздел

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