FrameworkElement.Height プロパティ

リファレンス

定義

名前空間:: System.Windows

アセンブリ:: PresentationFramework.dll

重要

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

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

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 以上にする必要があります。

属性: TypeConverterAttribute LocalizabilityAttribute

注釈

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 属性の使用方法

<object Height="double"/>

\- または -

<object Height="qualifiedDouble"/>

\- または -

<object Height="Auto"/>

XAML 値

double
Double

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

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

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

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

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

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

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

依存プロパティ情報


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

適用対象

こちらもご覧ください

ActualHeight