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 をレンダリングするレイアウト パスにまだ関与していない場合、既定値が発生する可能性があります。

注釈

Note

ActualWidthProperty バッキング フィールドがありますが、ActualWidth はプロパティ変更通知を発生させず、依存関係プロパティではなく通常の CLR プロパティと見なす必要があります。

ActualWidth は計算プロパティです。 計算はレイアウト パスの結果であり、オブジェクトは、その連続するレイアウト親のロジックに従ってレイアウトでサイズが設定されます。 詳細については、「 XAML を使用してレイアウトを定義する」を参照してください。

ActualWidth には、レイアウト システムによる操作により、値に対する複数または増分の変更が報告される場合があります。 レイアウトの反復処理中に値を取得した場合でも、レイアウト システムでは、子オブジェクトに必要な領域のメジャー、親オブジェクトによる制約などを計算している可能性があります。 値は実際のレンダリング パスに基づいているため、 Width などのプロパティの設定値よりもわずかに遅れる可能性があります。これは、入力変更の基礎になる可能性があります。

ElementName バインドの目的で、ActualWidth は変更時に更新を投稿しません (非同期および実行時に計算される性質のため)。 ElementName バインドのバインド ソースとして ActualWidth を使用しないでください。 ActualWidth に基づく更新が必要なシナリオがある場合は、 SizeChanged ハンドラーを使用します。

適用対象

こちらもご覧ください