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。

屬性

備註

Height 是指定高度資訊的三個可寫入屬性 FrameworkElement 之一。 其他兩個是 MinHeightMaxHeight 。 如果這些值之間發生衝突,則實際高度判斷的應用程式順序是,首先 MinHeight 必須接受 ,最後 MaxHeight ,如果是在界限內, Height 則為 。

如果這個專案是其他元素內的子專案,則此屬性設定為值實際上是建議的值。 配置系統以及父元素的特定版面配置邏輯,將會在版面配置程式期間使用值作為非系結輸入。 實際上, FrameworkElement 幾乎一律是其他專案的子項目;即使您在 上 Window 設定 Height 也一樣。 (針對 Window ,當基礎應用程式模型建立建立裝載應用程式的 Hwnd 的基本轉譯假設時,就會使用該值。)

除了可接受的 Double 值之外,這個屬性也可以是 Double.NaN 。 這是您在程式碼中指定自動調整大小行為的方式。 在 XAML 中,您會將值設定為字串 「Auto」 (不區分大小寫) ,以啟用自動調整大小行為。 自動調整大小行為表示元素會填滿它可用的高度。 不過請注意,除非特別重新啟用,否則特定控制項經常透過預設主題樣式提供預設值,以停用自動調整大小行為。

此屬性的傳回值一律與設定為它的任何值相同。 相反地,的值 ActualHeight 可能會有所不同。 這可能會以靜態方式發生,因為版面配置因為某些原因而拒絕建議的大小,或暫時拒絕。 版面配置系統本身的運作方式與屬性系統的 集合 Height 相對,而且可能尚未處理該特定調整大小屬性變更。

值限制 Double 是由機制 ValidateValueCallback 強制執行。 如果您嘗試設定不正確值,則會擲回運行時例外狀況。

除了驗證檢查之外,配置系統強制執行的非決定性上限值 Height , (這是非常大的數位,大於 Single.MaxValue 但小於 Double.MaxValue) 。 如果您超過此系結,元素將不會轉譯,而且不會擲回例外狀況。 請勿設定 Height 為大於任何可能視覺效果顯示大小上限的值,或者您可能超過這個不具決定性的上限。

XAML Attribute Usage

<object Height="double"/>  

-或-

<object Height="qualifiedDouble"/>  

-或-

<object Height="Auto"/>  

XAML 值

double
Double

值等於或大於 0.0 的 Double 字串表示。 如需上限資訊,請參閱<備註>。 此值會解譯為裝置獨立單位, (1/96 英吋) 測量。 字串不需要明確包含小數點。 例如, 的值 1 是可接受的。

qualifiedDouble
如上所述的 雙精度 浮點數,後面接著下列其中一個單位宣告字串: px 、、、 incmpt

px (預設) 是裝置獨立單位 (,每個單位 1/96 英吋)

in 為英吋;1in==96px

cm 為公分;1cm== (96/2.54) px

pt 為點;1pt== (96/72) px

Auto
啟用自動調整大小行為。 請參閱<備註>。

相依性屬性資訊

識別碼欄位 HeightProperty
設定為 的中繼資料屬性 true AffectsMeasure

適用於

另請參閱