FrameworkElement.Width 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定元素的寬度。

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

屬性值

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 Attribute Usage

<object Width="double"/>  

-或-

<object Width ="qualifiedDouble"/>  

-或-

<object Width ="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
啟用自動調整大小行為。 請參閱＜備註＞。

相依性屬性資訊

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