FrameworkElement.Height プロパティ

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml
編集

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

public:
 property double Height { double get(); void set(double value); };
double Height();

void Height(double value);
public double Height { get; set; }
var double = frameworkElement.height;
frameworkElement.height = double;
Public Property Height As Double
<frameworkElement Height="double"/>
-or-
<frameworkElement Height="Auto"/>

プロパティ値

Double

オブジェクトの高さ (ピクセル単位)。 既定値は NaN です。 特別な NaN 値を除き、この値は 0 以上である必要があります。

例

この例では、実行時に作成され、そのコンテンツの初期化と、Width や Background などのHeight基本的な表示プロパティが必要な UI 要素の単純なプロパティ セットを示します。 (Background は実際には、FrameworkElement で定義されていない Control プロパティです)。

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";

Dim button2 As Button = New Button
button2.Height = 50
button2.Width = 100
button2.Background = New SolidColorBrush(Colors.Blue)
button2.Content = "Click Me"

注釈

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

いくつかの FrameworkElement 派生型も Shape から派生しています。 すべてのクラスが外観をShape指定するために使用または幅を使用Heightするわけではありません。代わりに、ポイントのセットを定義する可能性のある特定のプロパティを使用します。 この場合、a Height または Width は計算されますが、通常は直接設定されません。

カスタム クラスにも同様の考慮事項があります。クラスには、ディメンションを指定する際に意味のあるプロパティが存在する場合があります。また、Width よりもHeight大きい値を指定する場合もあります。 Height または Width 、メンバーとして引き続き使用でき、設定可能です。

または Width プロパティがHeight設定されているオブジェクトは、ほとんどの場合、別の親の子コレクション内の子オブジェクトであり、設定またはWidth値への設定Heightは、レイアウト プロセスの推奨値にすぎません。 レイアウト システムと親のクラスの特定のレイアウト ロジックでは、レイアウト 処理中に値がバインドされていない入力として使用され、オブジェクトのクリップ、サイズ変更、コンテナーのサイズ変更、またはレイアウト内の複数の参加オブジェクトにまたがるこれらの動作の組み合わせが必要になる場合があります。 余白とパディングは、使用可能なサイズにも影響します。 詳しくは、「配置、余白、およびパディング」をご覧ください。

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

負の Height 値は使用できません。

また、表示可能なビジュアル表示の最大サイズを大幅に超える値には設定 Height しないでください。

"Auto" と NaN

既定値と HeightWidth は "Auto" で、NaN で表されます。 XAML マークアップでは、文字列 "Auto" を使用して値を NaN に設定できます。

Note

C# では、 Double.NaN から NaN を取得できます。

C++ では、 NAN マクロ または std::numeric_limits<double>::quiet_NaN().

NaN のテストには == 演算子を使用しないでください。

C# では、 Double.IsNaN() を使用して NaN をテストします。

C++ では、 isnan() を使用して NaN をテストします。

適用対象

こちらもご覧ください