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

除了验证检查之外,布局系统强制实施 (这是一个非常大的数字,大于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、、incmpt

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

in 为英寸;1in==96px

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

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

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

依赖项属性信息

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

适用于