FrameworkElement.Width プロパティ

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: PresentationFramework.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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 つはMinWidth.MaxWidth これらの値の間に競合がある場合は、実際の幅の決定のための適用の順序を最初 MinWidth に受け入れ、次 MaxWidthに、これらのそれぞれが境界内にある場合は最後に受 Widthけ入れなければなりません。

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

このプロパティDouble.NaNは、許容されるDouble値に加えて、. 自動サイズ設定の動作を指定する方法は次のとおりです。 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 許容されます。

修飾されたDouble
上で説明した 倍精度浮動小数点 型の値の後に、次のいずれかの単位宣言文字列をpt``in``cm指定します。 px

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

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

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

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

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

依存プロパティ情報


識別子フィールド	WidthProperty
メタデータのプロパティが次に設定されている `true`	AffectsMeasure

適用対象