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 可寫屬性之一，指定高度資訊。 另外兩個是 MinHeight 和 MaxHeight。 若這些值存在衝突，實際高度判定的應用順序為：首先 MinHeight 必須遵守，然後 MaxHeight是，最後，若在範圍內，則為 Height。

如果這個元素是其他元素中的子元素，那麼將此屬性設為一個值其實只是建議值。 版面系統以及父元素的特定版面邏輯會在版面配置過程中將該值作為非綁定輸入使用。 在實務上，a 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

字串表示等 Double 於或大於 0.0 的值。 關於上界資訊，請參見備註。 此值被解釋為與裝置無關的單位（1/96英吋）。 字串不必明確包含小數點。 例如 1 ，值為可接受。

取得雙重資格如上所述的雙倍值，接著是以下其中一個單位宣告字串：px， in， cmpt， 。

px （預設）為裝置無關單位（每單位 1/96 吋）

in 是英吋;1in==96px

cm 是公分;1cm==（96/2.54） px

pt 是分數;1pt==（96/72） px

自動 能讓自動化行為得以實現。 請參閱備註。

相依財產資訊

另請參閱

• ActualHeight