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，這可能是輸入變更的基礎。

基於 ElementName 系結的目的，ActualWidth 不會在因非同步和執行時間計算本質) 而變更 (時張貼更新。 請勿嘗試使用 ActualWidth 做為 ElementName 系結的系結來源。 如果您有需要根據 ActualWidth 進行更新的案例，請使用 SizeChanged 處理常式。

另請參閱

• ActualHeight
• Width
• SizeChanged