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。 如果对象尚未加载且尚未参与呈现 UI 的布局传递，则可能会遇到默认值。

注解

注意

尽管它具有 ActualWidthProperty 后备字段，但 ActualWidth 不会引发属性更改通知，应将其视为常规 CLR 属性，而不是依赖属性。

ActualWidth 是一个计算属性。 计算是布局传递的结果，其中对象根据其连续布局父级的逻辑在布局中调整大小。 有关详细信息，请参阅 使用 XAML 定义布局。

由于布局系统的操作，ActualWidth 可能会对值进行多次或增量报告更改。 如果在布局仍在迭代时获取值，则布局系统可能仍在计算子对象所需的空间度量值、父对象的约束等。 由于该值基于实际的呈现传递，因此它可能会略微滞后于 Width 等属性的设置值，而 Width 可能是输入更改的基础。

出于 ElementName 绑定的目的，ActualWidth 在更改 (时不会发布更新，因为其异步和运行时计算性质) 。 请勿尝试使用 ActualWidth 作为 ElementName 绑定的绑定源。 如果方案需要基于 ActualWidth 进行更新，请使用 SizeChanged 处理程序。

另请参阅

• ActualHeight
• Width
• SizeChanged