FrameworkElement.Width 屬性

public:
 property double Width { 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 Width { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Width : double with get, set

Public Property Width As Double

屬性值

元件寬度，單位與裝置無關（每單位1/96英吋）。 預設值為 NaN。 此值必須等於或大於0.0。 關於上界資訊，請參見備註。

屬性

TypeConverterAttribute LocalizabilityAttribute

備註

這是三個指定寬度資訊的 FrameworkElement 屬性之一。 另外兩個是 MinWidth 和 MaxWidth。 若這些值存在衝突，則必須先 MinWidth 遵守實際寬度判定的順序，接著 MaxWidth，最後若兩者皆在界內，則 Width。

這個屬性的回傳值總是與設定為該屬性的任何值相同。 相較之下，這些 ActualWidth 價值可能會有所不同。 版面可能因某些原因拒絕了建議的尺寸。 此外，版面系統本身相對於屬性 Width 系統集合是非同步運作的，可能還沒處理過那個特定的尺寸屬性變更。

除了可 Double 接受的值外，此性質也可以是 Double.NaN。 這就是你如何指定自動尺寸行為的方式。 在 XAML 裡，你要把值設為字串「Auto」（不區分大小寫），這樣就能啟用自動大小調整的行為。 自動調整尺寸的行為意味著元素會填滿其可用的寬度。 不過請注意，特定控制項常常會在預設樣式中提供預設值，除非特別重新啟用，否則會停用自動大小設定。

除了驗證檢查外，還有一個非確定性的上界 Width ，由佈局系統強制執行（這是一個非常大的數字，大於 Single.MaxValue 但小於 Double.MaxValue）。 如果超過這個限制，該元素就不會被渲染，也不會拋出任何例外。 請勿設定 Width 遠大於任何可能視覺顯示最大尺寸的值，否則可能會超過這個非確定性上限。

XAML 屬性使用方式

<object Width="double"/>

-或-

<object Width ="qualifiedDouble"/>

-或-

<object Width ="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

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

相依財產資訊