FrameworkElement.Height プロパティ

定義

要素の推奨される高さを取得または設定します。

public:
 property double Height { 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 Height { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Height : double with get, set
Public Property Height As Double

プロパティ値

Double

デバイスに依存しない単位 (ユニットあたり 1/96 インチ) の要素の高さ。 既定値は NaN です。 この値は 0.0 以上にする必要があります。

属性

注釈

Height は、高さ情報を指定する 3 つの書き込み可能なプロパティ FrameworkElement のいずれかです。 他の 2 つはMinHeight.MaxHeight これらの値の間に競合がある場合、実際の高さの決定のためのアプリケーションの順序は、最初 MinHeight に受け入れ、最後 MaxHeightに、それが境界内にある場合は、 Height受け入れなければならないということです。

この要素が他の要素内の子要素である場合、このプロパティを値に設定することは、実際には推奨される値にすぎません。 レイアウト システムと親要素の特定のレイアウト ロジックでは、レイアウト プロセス中に値がバインドされていない入力として使用されます。 実際には、a FrameworkElement は、ほとんど常に他の何かの子要素です。オンWindowHeight設定した場合でも. (この Window値は、基になるアプリケーション モデルが、アプリケーションをホストする Hwnd を作成する基本的なレンダリング前提条件を確立するときに使用されます)。

このプロパティDouble.NaNは、許容されるDouble値に加えて、. コードで自動サイズ設定の動作を指定する方法を次に示します。 XAML では、値を文字列 "Auto" (大文字と小文字は区別しない) に設定して、自動サイズ設定の動作を有効にします。 自動サイズ設定の動作は、要素が使用可能な高さを満たすことを意味します。 ただし、特定のコントロールでは、既定のテーマ スタイルを使用して既定値が提供されることが多く、特に再度有効にしない限り、自動サイズ設定の動作が無効になります。

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

値に対する値の Double 制限は、メカニズムによって ValidateValueCallback 適用されます。 無効な値を設定しようとすると、実行時例外がスローされます。

検証チェックに加えて、レイアウト システムによって適用される非決定的な上限があります Height (これは非常に大きな数値であり、より Single.MaxValue 大きいが小さい Double.MaxValue)。 このバインドを超えると、要素はレンダリングされず、例外はスローされません。 可能なビジュアル表示の最大サイズより大幅に大きい値に設定 Height しないでください。または、この非決定的上限を超える可能性があります。

XAML 属性の使用方法

<object Height="double"/>  

- または -

<object Height="qualifiedDouble"/>  

- または -

<object Height="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

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

依存プロパティ情報

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

適用対象

こちらもご覧ください