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 、、、 incmpt 、 。

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

in 為英吋;1in==96px

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

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

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

相依性屬性資訊

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