Поделиться через


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.

Атрибуты

Комментарии

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
Double

Строковое Double представление значения, равного или больше 0,0. Сведения о верхней границе см. в разделе "Примечания". Это значение интерпретируется как измерение независимой от устройства единицы измерения (1/96 дюйма). Строки не должны явно включать десятичные знаки. Например, допустимо значение 1 .

qualifiedDouble
Значение double , как описано выше, за которым следует одна из следующих строк объявления единиц: px, in, cm, pt.

px (по умолчанию) — независимые от устройства единицы измерения (1/96 дюйма на единицу).

in имеет значение в дюймах; 1in==96 пикселей

cm — сантиметры; 1cm==(96/2.54) px

pt — баллы; 1pt==(96/72) px

Автоматически
Включает поведение автомасштабирования. См. заметки.

Сведения о свойстве зависимостей

Поле идентификатора HeightProperty
Для свойств метаданных задано значение true AffectsMeasure

Применяется к

См. также раздел