FrameworkElement.ActualWidth Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает отрисованную ширину элемента FrameworkElement. См. заметки.
public:
property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double
Значение свойства
double
Ширина объекта (в пикселях). Значение по умолчанию равно 0. Значение по умолчанию может быть установлено, если объект не был загружен и еще не участвовал в проходе макета, который отрисовывает пользовательский интерфейс.
Комментарии
Примечание
Хотя у него есть резервное поле ActualWidthProperty , ActualWidth не создает уведомления об изменении свойств и его следует рассматривать как обычное свойство CLR, а не свойство зависимости.
ActualWidth является вычисляемым свойством. Вычисления являются результатом прохода макета, когда размер объекта в макете соответствует логике последующих родительских элементов макета. Дополнительные сведения см. в статье Определение макетов с помощью XAML.
ActualWidth может иметь несколько или добавочных изменений значения из-за операций системы макета. Если вы получаете значение во время итерации макета, система макета может по-прежнему вычислять необходимую меру пространства для дочерних объектов, ограничения родительского объекта и т. д. Поскольку значение основано на фактическом проходе отрисовки, оно может немного отставать от заданного значения свойств, таких как Width, что может быть основой для изменения входных данных.
В целях привязки ElementName ActualWidth не публикует обновления при изменении (из-за асинхронного и вычисляемого характера во время выполнения). Не пытайтесь использовать ActualWidth в качестве источника привязки для привязки ElementName . Если у вас есть сценарий, требующий обновлений на основе ActualWidth, используйте обработчик SizeChanged .