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

プロパティ値

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

属性

TypeConverterAttribute LocalizabilityAttribute

注釈

Height は、高さ情報を指定する FrameworkElement の 3 つの書き込み可能なプロパティの 1 つです。 他の 2 つは MinHeight と MaxHeightです。 これらの値の間に競合がある場合、実際の高さ決定の適用順序は、最初の MinHeight を受け入れ、次に MaxHeightし、最後に境界内にある場合は Height。

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

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

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

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

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

XAML 属性の使用法

<object Height="double"/>

-又は-

<object Height="qualifiedDouble"/>

-又は-

<object Height="Auto"/>

XAML 値

ダブルDouble

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

qualifiedDouble 上記の double 値の後に、次のいずれかの単位宣言文字列 ( px、 in、 cm、 pt)。

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

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

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

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

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

依存関係プロパティ情報

こちらもご覧ください

• ActualHeight