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. Значение по умолчанию может возникнуть, если объект не загружен и еще не участвовал в передаче макета, отображающей пользовательский интерфейс.
Комментарии
Note
Хотя он имеет поле резервной копии ActualWidthProperty, ActualWidth не вызывает уведомления об изменении свойств, и его следует рассматривать как обычное свойство CLR, а не свойство зависимостей.
ActualWidth — это вычисляемое свойство. Вычисления являются результатом прохода макета, где объект имеет размер в макете в соответствии с логикой его последовательных родителей макета. Дополнительные сведения см. в разделе "Определение макетов с помощью XAML".
ActualWidth может иметь несколько или добавочных изменений значения из-за операций системы макета. Если вы получаете значение во время итерации макета, система макета может по-прежнему вычислять необходимую меру пространства для дочерних объектов, ограничения родительского объекта и т. д. Так как значение основано на фактическом проходе отрисовки, оно может немного отстать от заданного значения свойств, таких как Width, что может быть основой входного изменения.
В целях привязки ElementName ActualWidth не публикует обновления при изменении (из-за его асинхронной и вычисляемой природы во время выполнения). Не пытайтесь использовать ActualWidth в качестве источника привязки для привязки ElementName . Если у вас есть сценарий, требующий обновлений на основе ActualWidth, используйте обработчик SizeChanged .