FrameworkElement.Height 属性

public:
 property double Height { 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 Height { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
member this.Height : double with get, set

Public Property Height As Double

属性值

元素的高度，以与设备无关的单位（每单位 1/96 英寸）。 默认值为 NaN。 此值必须等于或大于 0.0。

属性

TypeConverterAttribute LocalizabilityAttribute

注解

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

如果此元素是其他元素中的子元素，则将此属性设置为值实际上只是建议的值。 布局系统和父元素的特定布局逻辑将在布局过程中将该值用作非绑定输入。 实际上，一个FrameworkElement几乎总是其他东西的子元素;即使设置打开HeightWindow。 （对于 Window，当基础应用程序模型建立创建承载应用程序的 Hwnd 的基本呈现假设时，将使用该值。

除了可接受的 Double 值外，此属性也可以是 Double.NaN。 这就是在代码中指定自动大小调整行为的方式。 在 XAML 中，将值设置为字符串“Auto”（不区分大小写），以启用自动大小调整行为。 自动调整大小行为意味着该元素将填充其可用的高度。 但是请注意，特定控件经常通过其默认主题样式提供默认值，这些样式将禁用自动调整大小行为，除非它专门重新启用。

此属性的返回值始终与为其设置的任何值相同。 相比之下，该值 ActualHeight 可能有所不同。 这可以通过静态方式发生，因为布局出于某种原因拒绝了建议的大小，或者暂时拒绝。 布局系统本身相对于属性系统的集合 Height 异步工作，并且可能尚未处理该特定的大小调整属性更改。

值限制 Double 由机制 ValidateValueCallback 强制执行。 如果尝试设置无效值，则会引发运行时异常。

除了验证检查之外，布局系统还 Height 强制实施该限制的不确定上限值（这个数字非常大，大于 Single.MaxValue 但小于 Double.MaxValue）。 如果超出此限制，则元素将不会呈现，并且不会引发异常。 不要设置为 Height 明显大于任何可能视觉显示的最大大小的值，或者可能超出此不确定上限。

XAML 属性用法

<object Height="double"/>

-或-

<object Height="qualifiedDouble"/>

-或-

<object Height="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

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

Dependency 属性信息

另请参阅

• ActualHeight