FrameworkElement.Height 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定項目的建議高度。

C#

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Height { get; set; }

屬性值

Double

元素的高度，以裝置獨立單位 (每單位 1/96 英吋) 。 預設值是 NaN。 這個值必須等於或大於 0.0。

屬性

TypeConverterAttribute LocalizabilityAttribute

備註

Height 是指定高度資訊的三個可寫入屬性 FrameworkElement 之一。 其他兩個是 MinHeight 和 MaxHeight 。 如果這些值之間發生衝突，則實際高度判斷的應用程式順序是，首先 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

XAML

<object Height="double"/>  

-或-

XAML

<object Height="qualifiedDouble"/>  

-或-

XAML

<object Height="Auto"/>  

XAML 值

double
Double

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

qualifiedDouble
如上所述的 雙精度 浮點數，後面接著下列其中一個單位宣告字串： px 、、、 incm 、 pt 。

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

in 為英吋;1in==96px

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

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

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

相依性屬性資訊

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

適用於

另請參閱

• ActualHeight