FrameworkElement.Width プロパティ

定義

名前空間:

System.Windows

アセンブリ:

PresentationFramework.dll

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

public:
 property double Width { double get(); void set(double value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Width { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set

Public Property Width As Double

プロパティ値

Double

デバイスに依存しない単位 (ユニットあたり 1/96 インチ) の要素の幅。 既定値は NaN です。 この値は 0.0 以上にする必要があります。 上限については、「解説」を参照してください。

属性

TypeConverterAttribute LocalizabilityAttribute

注釈

これは、幅情報を指定する の FrameworkElement 3 つのプロパティのいずれかです。 他の 2 つの は と MaxWidthですMinWidth。 これらの値の間に競合がある場合は、実際の幅決定の適用順序を最初 MinWidth に受け入れ、次 MaxWidthに を受け入れ、最後にこれらの各が境界 Width内にある場合は を受け入れなければなりません。

このプロパティの戻り値は、それに設定された値と常に同じです。 これに対し、 の値は ActualWidth 異なる場合があります。 レイアウトが何らかの理由で推奨サイズを拒否した可能性があります。 また、レイアウト システム自体は のプロパティ システム セットに対して非同期的に動作し、特定のサイズ設定プロパティの Width 変更をまだ処理していない可能性があります。

このプロパティには、許容される Double 値に加えて、 を指定 Double.NaNすることもできます。 これは、自動サイズ設定の動作を指定する方法です。 XAML では、値を文字列 "Auto" (大文字と小文字は区別しない) に設定して、自動サイズ設定の動作を有効にします。 自動サイズ設定の動作は、要素が使用可能な幅を埋めるという意味です。 ただし、特定のコントロールでは、既定のスタイルで既定値が提供されることが多く、特に再び有効にしない限り、自動サイズ設定の動作が無効になります。

検証チェックに加えて、レイアウト システムによって適用される に対Widthして非決定的な上限がバインドされています (これは非常に多く、よりSingle.MaxValue大きいが よりDouble.MaxValue小さい)。 このバインドを超えると、 要素はレンダリングされず、例外はスローされません。 可能なビジュアル表示の最大サイズを大幅に超える値に設定 Width しないでください。または、この非決定的な上限を超える可能性があります。

XAML 属性の使用方法

<object Width="double"/>  

\- または -

<object Width ="qualifiedDouble"/>  

\- または -

<object Width ="Auto"/>  

XAML 値

double
Double

0.0 以上の Double 値の文字列表現。 上限については、「解説」を参照してください。 この値は、デバイスに依存しない単位 (1/96 インチ) の測定として解釈されます。 文字列に明示的に小数点を含める必要はありません。 たとえば、 の 1 値は許容されます。

qualifiedDouble
上で説明した double 値の後に、次のいずれかの単位宣言文字列 ( px、 in、、 cm) ptが続きます。

px (既定値) はデバイスに依存しない単位 (1 ユニットあたり 1/96 インチ) です

in はインチ。1in==96px

cm はセンチメートルです。1cm==(96/2.54) px

pt はポイント。1pt==(96/72) px

Auto
自動サイズ設定の動作を有効にします。 「解説」を参照してください。

依存プロパティ情報

識別子フィールド	WidthProperty
に設定されたメタデータ プロパティ true	AffectsMeasure