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/1/96 インチ)。 既定値は NaN です。 この値は 0.0 以上にする必要があります。 上限については、「解説」を参照してください。

属性
TypeConverterAttribute LocalizabilityAttribute

注釈

これは FrameworkElement 、の幅情報を指定する3つのプロパティのうちの1つです。 もう1つは 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
Double

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

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

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

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

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

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

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

依存プロパティ情報
識別子フィールド WidthProperty
メタデータプロパティがに設定される true AffectsMeasure

適用対象