FrameworkElement.Height プロパティ

定義

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

C#
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Height { get; set; }

プロパティ値

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

属性

注釈

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

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

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

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

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

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

XAML 属性の使用方法

XAML
<object Height="double"/>  

\- または -

XAML
<object Height="qualifiedDouble"/>  

\- または -

XAML
<object Height="Auto"/>  

XAML 値

double
Double

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

qualifiedDouble
上で説明した double 値の後に、次のいずれかの単位宣言文字列 ( pxin、、 cm) ptが続きます。

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

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

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

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

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

依存プロパティ情報

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

適用対象

製品 バージョン
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

こちらもご覧ください