语言

FrameworkElement.Width 属性

定义

获取或设置 FrameworkElement 的宽度。

public:
 property double Width { double get(); void set(double value); };
double Width();

void Width(double value);
public double Width { get; set; }
var double = frameworkElement.width;
frameworkElement.width = double;
Public Property Width As Double
<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>

属性值

Double

double

对象的宽度(以像素为单位)。 默认值为 NaN。 除特殊 NaN 值外,此值必须等于或大于 0。

示例

此示例演示在运行时创建的 UI 元素的简单属性集,需要初始化其内容和基本显示属性,例如 HeightWidth 和 Background。 (背景 实际上是 一个控件 属性,不是 由 FrameworkElement 定义的。

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";

注解

Width 是 FrameworkElement 上的三个可写属性之一,用于指定宽度信息。 另外两个是 MinWidth 和 MaxWidth。 如果这些值之间存在冲突,则实际宽度确定的应用程序顺序是,首先MinWidth必须遵循,最后MaxWidth,如果它位于边界内, Width

多个 FrameworkElement 派生类型也派生自 Shape。 并非所有 Shape 类都使用 Height 或 Width 指定其外观,而是使用可能定义一组点的特定属性。 在这种情况下,会计算或HeightWidth计算,但通常不会直接设置。

自定义类可能有类似的注意事项,其中类可能具有比 Height 或 Width更有意义的属性来指定维度。 Height 或 Width 同时作为成员提供,并且是可设置的。

设置 Height 或 Width 属性的对象几乎始终是另一个父子集合中的子对象,并且设置 Height 或 Width 设置为值只是布局过程的建议值。 布局系统以及父类的特定布局逻辑将在布局过程中将该值用作非绑定输入,并且可能需要剪辑、调整对象大小、调整容器大小或跨布局中多个参与对象的这些行为的某种组合。 边距和填充也会影响可用大小。 有关详细信息,请参阅 对齐、边距和填充。

此属性的返回值始终与为其设置的任何值相同。 相比之下, ActualWidth 属性的值可能有所不同。 差异可以静态发生,因为布局拒绝了建议的大小或暂时性。 布局系统本身相对于属性系统集 Width异步工作,布局系统可能尚未处理该大小调整属性更改。

不允许使用 Width 负值。

此外,不要设置为 Width 明显大于任何可能视觉显示的最大大小的值。

“Auto”和 NaN

Height 的默认值为Width“Auto”,由 NaN 表示。 在 XAML 标记中,可以使用字符串“自动”将值设置为 NaN。

注释

在 C# 中,可以从 Double.NaN 获取 NaN。

在 C++ 中,可以使用 NAN 宏 或 std::numeric_limits<double>::quiet_NaN().

请勿使用 == 运算符测试 NaN。

在 C# 中,使用 Double.IsNaN() 测试 NaN。

在 C++ 中,使用 isnan() 测试 NaN。

适用于

另请参阅