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

等于或大于 0.0 的值的 Double 字符串表示形式。 有关上限信息，请参阅“备注”。 此值被解释为与设备无关的单位（1/96 英寸）测量。 字符串不需要显式包含小数点。 例如，可接受的 1 值。

qualifiedDouble如上所述的双精度值，后跟以下单位声明字符串之一：px、、in、 cmpt。

px （默认值） 是独立于设备的单位（每单位 1/96 英寸）

in 为英寸;1in==96px

cm 为厘米;1cm==（96/2.54） px

pt is points;1pt==（96/72） px

Auto 启用自动调整行为。 请参阅“备注”。

Dependency 属性信息