要素の幅を取得または設定します。これは、
依存関係プロパティです。
名前空間: System.Windows
アセンブリ: PresentationFramework (presentationframework.dll 内)
XML 名前空間 : http://schemas.microsoft.com/winfx/2006/xaml/presentation
<TypeConverterAttribute(GetType(LengthConverter))> _
<LocalizabilityAttribute(LocalizationCategory.None, Readability:=Readability.Unreadable)> _
Public Property Width As Double
Dim instance As FrameworkElement
Dim value As Double
value = instance.Width
instance.Width = value
[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)]
public double Width { get; set; }
[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory::None, Readability=Readability::Unreadable)]
public:
virtual property double Width {
double get () sealed;
void set (double value) sealed;
}
/** @property */
public final double get_Width ()
/** @property */
public final void set_Width (double value)
public final function get Width () : double
public final function set Width (value : double)
<object Width="double"/>
- or –
<object Width ="qualifiedDouble"/>
- or -
<object Width ="Auto"/>
- double
-
0.0 以上の Double 型の値の文字列表現。上限については、「解説」を参照してください。この値は、デバイスに依存しない単位 (1/96 インチ) 単位として解釈されます。文字列には、小数点を明示的に含める必要はありません。たとえば、1 は値として受け入れられます。
- qualifiedDouble
-
単位宣言文字列 px、in、cm、pt のいずれかが後に続く、上に挙げた double 型の値。
px (既定値) は デバイスに依存しない単位 (1 単位は 1/96 インチ) です。
in はインチです (1in==96px)。
cm はセンチメートルです (1 cm==(96/2.54) px)。
pt はポイントです (1pt==(96/72) px)。
- Auto
-
自動サイズ変更を有効にします。「解説」を参照してください。
プロパティ値
要素の幅 (デバイスに依存しない単位 (1 単位は 1/96 インチ))。既定値は Double.NaN です。この値は、0.0 以上である必要があります。上限については、「解説」を参照してください。
このプロパティは、幅情報を指定する FrameworkElement の 3 つのプロパティのうちの 1 つです。他の 2 つは、MinWidth と MaxWidth です。これらの値の間に競合が発生した場合は、まず MinWidth、次に MaxWidth を適用し、この 2 つが範囲内にあるときは、最後に Width を適用して実際の幅を決定します。
このプロパティの戻り値は、常に設定値と同じです。これに対し、ActualWidth の値は異なる場合があります。まず、何らかの理由で推奨サイズがレイアウトによって拒否される場合があります。また、レイアウト システムそのものが、プロパティ システムによる Width の設定に対して非同期で動作するため、特定のサイズ設定プロパティの変更がまだ処理されていない場合もあります。
Double 型の値を受け入れることができるだけでなく、このプロパティは Double.NaN にすることもできます。自動サイズ変更動作を指定する場合にこの値を使用します。XAML では、値を文字列 "Auto" (大文字/小文字の区別なし) に設定して自動サイズ変更動作を有効にします。自動サイズ変更動作では、要素の幅は利用可能な最大の幅になります。ただし、特定のコントロールの既定のスタイルで既定値が指定される場合も多く、その場合は自動サイズ変更動作は (改めて有効にしない限り) 無効になります。
検証チェックに加えて、レイアウト システムによって適用される Width には非決定性の上限値があります (これは、Single.MaxValue より大きいが Double.MaxValue より小さい、非常に大きな値です)。この上限値を超えると、要素は描画されず、例外も発生しません。表示可能な最大サイズを大きく超える値を Width に設定しないでください。この非決定性の上限値を超える可能性があります。
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
.NET Framework
サポート対象 : 3.0