共用方式為


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。 如需上限資訊,請參閱<備註>。

屬性

備註

這是指定寬度資訊之三個屬性的 FrameworkElement 其中之一。 其他兩個是 MinWidthMaxWidth 。 如果這些值之間發生衝突,則必須先接受實際寬度判斷 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

適用於