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”， (不区分大小写) 启用自动调整大小行为。 自动调整大小行为意味着元素将填充其可用的宽度。 但请注意，特定控件经常以默认样式提供默认值，这些默认值将禁用自动调整大小行为，除非专门重新启用它。

除了验证检查之外，布局系统强制实施 (这是一个非常大的数字，大于Single.MaxValue但小于Double.MaxValue) ，还有一个不确定的Width上限。 如果超出此边界，元素将不会呈现，并且不会引发异常。 不要设置为 Width 明显大于任何可能视觉对象显示的最大大小的值，否则可能会超过此不确定的上限。

XAML 属性用法

<object Width="double"/>  

- 或 -

<object Width ="qualifiedDouble"/>  

- 或 -

<object Width ="Auto"/>  

XAML 值

double
Double

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

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

px (默认) 为与设备无关的单位， (单位) 1/96 英寸

in 为英寸;1in==96px

cm 为厘米;1cm== (96/2.54) px

pt 是点;1pt== (96/72) px

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

依赖项属性信息

标识符字段	WidthProperty
元数据属性设置为 true	AffectsMeasure