FrameworkElement.Width プロパティ (System.Windows)

Width プロパティ

低帯域幅での表示をオンにする

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

FrameworkElement.Width プロパティ

要素の幅を取得または設定します。これは、依存関係プロパティです。

名前空間: System.Windows
アセンブリ: PresentationFramework (presentationframework.dll 内)
XML 名前空間 : http://schemas.microsoft.com/winfx/2006/xaml/presentation

構文

Visual Basic (宣言)

<TypeConverterAttribute(GetType(LengthConverter))> _
<LocalizabilityAttribute(LocalizationCategory.None, Readability:=Readability.Unreadable)> _
Public Property Width As Double

Visual Basic (使用法)

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; }

C++

[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)

JScript

public final function get Width () : double

public final function set Width (value : double)

XAML 属性の使用

<object Width="double"/>
- or –
<object Width ="qualifiedDouble"/>
- or -
<object Width ="Auto"/>

XAML の値

 double 
 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 以上である必要があります。上限については、「解説」を参照してください。

依存プロパティ情報

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

解説

このプロパティは、幅情報を指定する 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 でサポートされています。

バージョン情報