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

double

物體的高度，以像素為單位。 預設是 NaN。 除了特殊的 NaN 值外，此值必須等於或大於 0。

範例

此範例展示了一個簡單的 UI 屬性集合，該元素在執行時建立，需要初始化其內容及基本顯示屬性，如 Height 和 寬度 與 背景。 （背景 其實是 控制 屬性，並非由 FrameworkElement 定義。）

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

備註

Height 是 FrameworkElement 上三個可寫入屬性之一，指定高度資訊。 另外兩個是 最小身高（MinHeight ）和 最大身高（MaxHeight）。 若這些值存在衝突，實際高度判定的應用順序為：首先 MinHeight 必須遵守，然後 MaxHeight是，最後，若在範圍內，則為 Height。

FrameworkElement 衍生的多種類型也源自 Shape。 並非所有 Shape 類別都使用 Height 或 Width 來指定外觀，而是使用特定的屬性來定義一組點。 此時會計算 a Height 或 Width ，但通常不會直接設定。

自訂類別可能也有類似考量，類別的屬性可能比 Are Height 或 Width 更適合指定尺寸。 Height 或者 Width 兩者都仍可作為成員使用且可設定。

設定 Height or Width 屬性的物件幾乎總是其他父子集合中的子物件，而 set Height or Width 只是版面流程中建議的值。 layout 系統以及父類別的特定 layout 邏輯會在 layout 過程中將該值作為非綁定輸入使用，可能需要裁剪、調整物件大小、調整容器大小，或是這些行為的組合，跨越多個參與物件。 邊距和填充也會影響可用尺寸。 如需詳細資訊，請參閱 對齊、邊界和邊框間距。

這個屬性的回傳值總是與設定為該屬性的任何值相同。 相較之下， ActualHeight 物業的價值可能會有所不同。 變異可以是靜態發生，因為版面拒絕了建議的大小，或是暫時發生。 版面系統本身是相對於屬性系統的高度集合非同步運作的，而版面系統可能還沒處理這個尺寸屬性的變更。

不允許為負值 Height 。

此外，不要設定 Height 一個明顯大於任何可能視覺顯示最大大小的值。

「Auto」與 NaN

和 寬度的預設值Height為「自動」，以 NaN 表示。 在 XAML 標記中，你可以用字串「Auto」來設定 NaN。

Note

在 C# 中，你可以從 Double.NaN 取得 NaN。

在 C++ 中，你可以使用 NAN 巨集 或 std::numeric_limits<double>::quiet_NaN()來取得 NaN。

不要用 == 算子來測試NaN。

在 C# 中，使用 Double.IsNaN（） 來測試 NaN。

在 C++ 中，使用 isnan（） 來測試 NaN。

適用於

另請參閱