エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

FrameworkElement.Width プロパティ

2013/12/12

FrameworkElement の幅を取得または設定します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

public double Width { get; set; }
<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>

プロパティ値

型: System.Double
要素の幅 (論理ピクセル単位)。既定値は、Double.NaN です。特殊な Double.NaN 値を除いて、この値は 0 以上である必要があります。上限については、「解説」を参照してください。

依存関係プロパティの識別子フィールド:  WidthProperty

複数の FrameworkElement 派生クラスが、Shape からも派生します。通常は、すべての Shape クラスが Height または Width を使用して外観を指定するわけではなく、代わりに、点のセットを定義する特定のプロパティを使用します。この場合、Height または Width は計算されますが、通常は直接設定されません。

同様に、カスタム クラスでも、大きさを指定する際に HeightWidth よりも重要な意味があるプロパティを持つクラスがあることに注意してください。この場合、望ましい動作が Height または Width の設定を有効にしないことであっても、Height または Width はどちらも引き続きメンバーとして使用でき、設定可能です。クラスのコンシューマーが Height プロパティと Width プロパティを直接設定できないようにシャドウを行う方が重要な場合もあります。

TextBlock はコンテナー オブジェクトの例です。この場合、コンテナー内のテキストが表示されます。そのテキストのサイズは、描画された TextBlock のサイズに影響する可能性があるため、TextBlock は指定された Height または Width を受け入れない場合があります。TextBlock のようなコンテナー オブジェクトでは、計算されたサイズを公開する ActualHeight プロパティと ActualWidth プロパティを確認する必要があります。

負の Width 値は使用できません。Width に整数以外の値を設定することも技術的には可能です。XAML やコードでそのように設定した場合、値は整数以外の値として保持されますが、通常は避けるようにしてください。整数以外の値を設定しても、通常は、レイアウトの既定の丸め処理によって丸められます。「」を参照してください。

検証チェックに加えて、Width には非決定性の上限値があります (これは、Single.MaxValue より大きいが Double.MaxValue より小さい、非常に大きな値です)。表示可能な最大サイズを大きく超える値を Width に設定しないでください。この非決定性の上限値を超える可能性があります。

"Auto" レイアウトと Double.NaN

Height および Width の既定値は 0 ではなく、Double.NaN です。Height および Width は、未設定の "Auto" 値を使用する機能をサポートしています。Height および Width は double 型の値であるため、Double.NaN はこの "Auto" の動作を表す特殊な値として使用されます。レイアウト システムでは、"Auto" 値は、オブジェクトを特定の論理ピクセル値ではなく、レイアウトで使用可能なサイズに設定するという意味に解釈されます。

レイアウトで使用するときにオブジェクトの "Auto" の動作を使用するには、Height および WidthDouble.NaN 既定値のままにしておきます。以前に値を設定している場合に、"Auto" の動作を再度有効にするには、Height および Width を明確に Double.NaN に設定します。

表示状態テンプレートの場合以外は一般的な方法ではありませんが、XAML で Height 属性および Width 属性が、double 値ではなく、文字列 Auto になるように、明示的に設定することもできます。XAML での Auto の設定は、TypeConverter の動作ではなく、XAML パーサーの特殊な動作です。

Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2014 Microsoft