FrameworkElement.Height プロパティ
要素の高さの推奨値を取得または設定します。これは、依存関係プロパティです。

名前空間: System.Windows
アセンブリ: PresentationFramework (presentationframework.dll 内)
XML 名前空間 :  http://schemas.microsoft.com/winfx/2006/xaml/presentation

構文

Visual Basic (宣言)
<LocalizabilityAttribute(LocalizationCategory.None, Readability:=Readability.Unreadable)> _
<TypeConverterAttribute(GetType(LengthConverter))> _
Public Property Height As Double
Visual Basic (使用法)
Dim instance As FrameworkElement
Dim value As Double

value = instance.Height

instance.Height = value
C#
[LocalizabilityAttribute(LocalizationCategory.None, Readability=Readability.Unreadable)] 
[TypeConverterAttribute(typeof(LengthConverter))] 
public double Height { get; set; }
C++
[LocalizabilityAttribute(LocalizationCategory::None, Readability=Readability::Unreadable)] 
[TypeConverterAttribute(typeof(LengthConverter))] 
public:
virtual property double Height {
	double get () sealed;
	void set (double value) sealed;
}
J#
/** @property */
public final double get_Height ()

/** @property */
public final void set_Height (double value)
JScript
public final function get Height () : double

public final function set Height (value : double)
XAML 属性の使用
<object Height="double"/>
- or -
<object Height="qualifiedDouble"/>
- or -
<object Height="Auto"/>
XAML の値
double

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

qualifiedDouble

単位宣言文字列 pxincmpt のいずれかが後に続く、上に挙げた double 型の値。

px (既定値) は デバイスに依存しない単位 (1 単位は 1/96 インチ) です。

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

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

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

Auto

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

プロパティ値

要素の高さ (デバイスに依存しない単位 (1 単位は 1/96 インチ))。既定値は Double.NaN です。この値は、0.0 以上である必要があります。上限については、「解説」を参照してください。
依存プロパティ情報

識別子フィールド

HeightProperty

true に設定されたメタデータのプロパティ

AffectsMeasure

解説

Height は、高さ情報を指定する FrameworkElement の 3 つの書き込み可能なプロパティのうちの 1 つです。他の 2 つは、MinHeightMaxHeight です。これらの値の間に競合が発生した場合は、まず MinHeight、次に MaxHeight を適用し、この 2 つが範囲内にあるときは、最後に Height を適用して実際の高さを決定します。

この要素が他の要素内の子要素である場合は、このプロパティの値を設定しても、実際には推奨値にしかなりません。その値は、レイアウト システムや親要素の特定のレイアウト ロジックによって、強制力のない入力としてレイアウト プロセスで使用されます。実際問題として、FrameworkElement はほとんど常に他の要素の子要素になっています。これは、WindowHeight を設定する場合でも同じです (Window の場合、その値は、基になるアプリケーション モデルで、アプリケーションをホストする Hwnd を作成する基本的な描画の前提が確立されるときに使用されます)。

Double 型の値を受け入れることができるだけでなく、このプロパティは Double.NaN にすることもできます。コードで自動サイズ変更動作を指定する場合にこの値を使用します。XAML では、値を文字列 "Auto" (大文字/小文字の区別なし) に設定して自動サイズ変更動作を有効にします。自動サイズ変更動作では、要素の高さは利用可能な最大の高さになります。ただし、特定のコントロールで既定のテーマ スタイルによって既定値が指定される場合も多く、その場合は自動サイズ変更動作は (改めて有効にしない限り) 無効になります。

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

Double 型の値に対する値の制約は、ValidateValueCallback 機構によって適用されます。無効な値を設定しようとすると、ランタイム例外が発生します。

検証チェックに加えて、レイアウト システムによって適用される Height には非決定性の上限値があります (これは、Single.MaxValue より大きいが Double.MaxValue より小さい、非常に大きな値です)。この上限値を超えると、要素は描画されず、例外も発生しません。表示可能な最大サイズを大きく超える値を Height に設定しないでください。この非決定性の上限値を超える可能性があります。

プラットフォーム

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0
参照

タグ :


Page view tracker