Информация
Запрошенная вами тема показана ниже. Однако эта тема не включена в библиотеку.

FrameworkElement.Height - свойство

Возвращает или задаёт предполагаемую высоту элемента.

Пространство имен:  System.Windows
Сборка:  PresentationFramework (в PresentationFramework.dll)
XMLNS для XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

[TypeConverterAttribute(typeof(LengthConverter))]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public double Height { get; set; }
<object Height="double"/>
- or -
<object Height="qualifiedDouble"/>
- or -
<object Height="Auto"/>

Значения XAML

double

Double

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

qualifiedDouble

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

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

in — дюймы; 1 дюйм==96 точек

cm — сантиметры; 1см==(96/2,54) точек

pt — точки; 1пиксель==(96/72) точек

Auto

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

Значение свойства

Тип: System.Double
Высота элемента в аппаратно-независимые единицы (1/96 дюйма на единицу). Значение по умолчанию — Double.NaN. Данное значение должно быть больше или равно 0,0. Сведения о верхнем пределе см. в разделе "Примечания".

Поле идентификатора

HeightProperty

Свойства метаданных, которым присвоено значение true

AffectsMeasure

Height — одно из трех записываемых свойств FrameworkElement, задающих информацию о высоте. Существуют еще два свойства — MinHeight и MaxHeight. В случае конфликта между этими значениями порядок определения фактической высоты в приложении следующий: сначала должно учитываться свойство MinHeight, затем MaxHeight, и наконец, если оно укладывается в границы, свойство Height.

Если элемент является дочерним для какого-либо другого, то установка значения для этого свойства является только предполагаемым значением. Это значение используется системой структуры, а также конкретной логикой структуры родительского элемента, в качестве несвязанного ввода в процессе структурирования. На практике FrameworkElement почти всегда является дочерним элементом какого-либо другого; даже если задать свойство Height для Window. (Для Window данное значение используется при установке базовой моделью приложения базовых предположений об отрисовке, которые создают Hwnd, где размещается приложение.)

Кроме приемлемых значений Double, данное свойство также может иметь значение Double.NaN. Это определяет, как задается в коде поведение автоматического изменения размеров. В Язык XAML в качестве значения задается строка "Auto" (без учета регистра), включающая поведение автоматического изменения размеров. Автоматическое изменение размеров предполагает, что элемент заполнит доступную ему высоту. Однако обратите внимание, что определенные элементы управления передают значения по умолчанию через свои тематические стили по умолчанию, которые отключают поведение автоматического изменения размеров, если его специально не включить повторно.

Возвращаемое значение данного свойства всегда равно любому значению, которое ему было задано. В противоположность этому, значение свойства ActualHeight может различаться. Это может происходить как статически, из-за отклонения структурой предполагаемого размера по какой-либо причине, или моментально. Сама система структуры работает асинхронно по отношению к установке системой свойств значения Height и может еще не обработать конкретное изменение свойства размера..

Ограничения на значение Double применяются механизмом ValidateValueCallback. Если попытаться задать недопустимое значение, произойдет исключение времени выполнения.

Кроме проверки допустимости, существует недетерминированная верхняя граница значения Height, применяемая системой структуры (очень большое число, больше Single.MaxValue, но меньше Double.MaxValue). Если превысить эту границу, элемент не будет визуализирован и исключение не произойдет. Не следует задавать для свойства Height значение, существенно превышающее максимальный размер любого возможного визуального дисплея, иначе можно превысить эту недетерминированную верхнюю границу.

В данном примере визуально показывается разница в получаемом изображении в результате задания четырех связанных с высотой свойств в Windows Presentation Foundation (WPF).

Класс FrameworkElement предоставляет четыре свойства, описывающих характеристики высоты элемента. Эти четыре свойства могут конфликтовать, и в этом случае значение, которое получает приоритет, определяется следующим образом: значение MinHeight получает приоритет перед значением MaxHeight, которое, в свою очередь, получает приоритет перед значением Height. Четвертое свойство ActualHeight доступно только для чтения и сообщает о фактической высоте, определенной при взаимодействии с процессом макета.

В следующих примерах Язык XAML (Extensible Application Markup Language) элемент Rectangle (rect1) представлен в качестве дочернего элемента объекта Canvas. Можно изменить свойства высоты Rectangle с помощью нескольких элементов ListBox, представляющих значения свойств MinHeight, MaxHeight и Height. Таким образом визуально отображается приоритет каждого свойства.


<Canvas Height="200" MinWidth="200" Background="#b0c4de" VerticalAlignment="Top"  HorizontalAlignment="Center" Name="myCanvas" Margin="0,0,0,50">
    <Rectangle HorizontalAlignment="Center" Canvas.Top="50" Canvas.Left="50"  Name="rect1" Fill="#4682b4" Height="100" Width="100"/>
</Canvas>


...


    <TextBlock Grid.Row="1" Grid.Column="0" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle Height:</TextBlock>
    <ListBox Grid.Column="1" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
    </ListBox>

	<TextBlock Grid.Row="1" Grid.Column="2" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MinHeight:</TextBlock>
    <ListBox Grid.Column="3" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMinHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem>
  </ListBox>      

    <TextBlock Grid.Row="1" Grid.Column="4" Margin="10,0,0,0" TextWrapping="Wrap">Set the Rectangle MaxHeight:</TextBlock>
    <ListBox Grid.Column="5" Grid.Row="1" Margin="10,0,0,0" Height="50" Width="50" SelectionChanged="changeMaxHeight">
      <ListBoxItem>25</ListBoxItem>
      <ListBoxItem>50</ListBoxItem>
      <ListBoxItem>75</ListBoxItem>
      <ListBoxItem>100</ListBoxItem>
      <ListBoxItem>125</ListBoxItem>
      <ListBoxItem>150</ListBoxItem>
      <ListBoxItem>175</ListBoxItem>
      <ListBoxItem>200</ListBoxItem> 
    </ListBox>


В следующих примерах кода программной части обрабатываются события, которые создаются событием SelectionChanged. Каждый обработчик берет значение из ListBox, анализирует его как Double и применяет это значение к указанному свойству высоты. Значения высоты также преобразуются в строку и записываются в различные элементы TextBlock (определение этих элементов не представлено в выбранном XAML).


private void changeHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.Height = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMinHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MinHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}
private void changeMaxHeight(object sender, SelectionChangedEventArgs args)
{
    ListBoxItem li = ((sender as ListBox).SelectedItem as ListBoxItem);
    Double sz1 = Double.Parse(li.Content.ToString());
    rect1.MaxHeight = sz1;
    rect1.UpdateLayout();
    txt1.Text= "ActualHeight is set to " + rect1.ActualHeight;
    txt2.Text= "Height is set to " + rect1.Height;
    txt3.Text= "MinHeight is set to " + rect1.MinHeight;
    txt4.Text= "MaxHeight is set to " + rect1.MaxHeight;
}


Полный код примера см. в разделе Пример свойств высоты.

.NET Framework

Поддерживается в версиях: 4.5, 4, 3.5, 3.0

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

Среда .NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Добавления сообщества

Показ:
© 2014 Microsoft