FrameworkElement.Width プロパティ

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

プロパティ値

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

属性

TypeConverterAttribute LocalizabilityAttribute

注釈

これは、幅情報を指定する FrameworkElement の 3 つのプロパティのいずれかです。 他の 2 つは MinWidth と MaxWidthです。 これらの値の間に競合がある場合は、実際の幅決定の適用順序を最初に 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

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

qualifiedDouble 上記の double 値の後に、次のいずれかの単位宣言文字列 ( px、 in、 cm、 pt)。

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

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

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

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

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

依存関係プロパティ情報