FrameworkElement.ActualWidth Свойство

  • Ссылка

Определение

Пространство имен:
Microsoft.UI.Xaml
Изменить

Возвращает отрисованную ширину элемента FrameworkElement. См. заметки.

public:
 property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double

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

Double

double

Ширина объекта (в пикселях). Значение по умолчанию равно 0. Значение по умолчанию может быть установлено, если объект не был загружен и еще не участвовал в проходе макета, который отрисовывает пользовательский интерфейс.

Комментарии

Примечание

Хотя у него есть резервное поле ActualWidthProperty , ActualWidth не создает уведомления об изменении свойств и его следует рассматривать как обычное свойство CLR, а не свойство зависимости.

ActualWidth является вычисляемым свойством. Вычисления являются результатом прохода макета, когда размер объекта в макете соответствует логике последующих родительских элементов макета. Дополнительные сведения см. в статье Определение макетов с помощью XAML.

ActualWidth может иметь несколько или добавочных изменений значения из-за операций системы макета. Если вы получаете значение во время итерации макета, система макета может по-прежнему вычислять необходимую меру пространства для дочерних объектов, ограничения родительского объекта и т. д. Поскольку значение основано на фактическом проходе отрисовки, оно может немного отставать от заданного значения свойств, таких как Width, что может быть основой для изменения входных данных.

В целях привязки ElementName ActualWidth не публикует обновления при изменении (из-за асинхронного и вычисляемого характера во время выполнения). Не пытайтесь использовать ActualWidth в качестве источника привязки для привязки ElementName . Если у вас есть сценарий, требующий обновлений на основе ActualWidth, используйте обработчик SizeChanged .

Применяется к

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