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

double

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

Комментарии

Примечание

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

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

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

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

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

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