UIElement.DesiredSize Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
public:
property Size DesiredSize { Size get(); };
Size DesiredSize();
public Size DesiredSize { get; }
var size = uIElement.desiredSize;
Public ReadOnly Property DesiredSize As 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);
}
Комментарии
DesiredSize обычно проверяется как один из факторов измерения при реализации переопределений поведения макета, таких как ArrangeOverride или MeasureOverride. В зависимости от логики макета родительского контейнера , DesiredSize может быть полностью уважаем, ограничения на DesiredSize могут применяться, и такие ограничения также могут изменить другие характеристики родительского элемента или дочернего элемента. Например, элемент управления, поддерживающий прокручиваемые регионы (но не является производным от элементов управления, которые уже поддерживают прокручиваемые регионы), может сравнить доступный размер с DesiredSize. Затем элемент управления может задать внутреннее состояние, включающее полосы прокрутки в пользовательском интерфейсе для этого элемента управления. Кроме того, Функция DesiredSize может игнорироваться, и элемент всегда получает макет, который имеет размер по другим соображениям, таким как проверка значений присоединенного свойства.
DesiredSize не будет содержать полезное значение, если в элементе не выполняется хотя бы один проход measure.
DesiredSize действительно предназначен только для использования при определении собственных методов переопределения макета. Если вы просто заинтересованы в размере элемента в пользовательском интерфейсе приложения во время выполнения, то вместо этого следует использовать свойства ActualWidth и ActualHeight . Вы можете проверить размер таким образом, если элемент зависит от методов динамического макета, таких как размер ячеек Сетки . Полагаться на значения ActualWidth и ActualHeight только в ситуациях, которые обязательно выполняются после запуска макета: например, в событиях загрузки или активируются действиями пользователей, которые возможны только после первоначальной отрисовки пользовательского интерфейса.
Применяется к
См. также раздел
- ArrangeOverride(Size)
- MeasureOverride(Size)
- Arrange(Rect)
- <xref:Microsoft.UI.Xaml.UIElement.Measure(Windows.Foundation.Size)%0a>
- Measure(Size)