FrameworkElement.Height 属性

  • 参考

定义

命名空间:
System.Windows
程序集:
PresentationFramework.dll

获取或设置元素的建议高度。

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

属性值

Double

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

属性
TypeConverterAttribute LocalizabilityAttribute

注解

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

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

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

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

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

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

XAML 属性用法

<object Height="double"/>

- 或 -

<object Height="qualifiedDouble"/>

- 或 -

<object Height="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
启用自动调整大小行为。 请参阅“备注”。

依赖项属性信息
标识符字段 HeightProperty
元数据属性设置为 true AffectsMeasure

适用于

另请参阅