TextBlock.LineHeight Свойство

Определение

Возвращает или задает высоту каждой строки содержимого.

[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
public double LineHeight { get; set; }

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

Высота строки в аппаратно-независимых пикселях в диапазоне от 0,0034 до 160 000. Значение NaN (эквивалентно значению атрибута "Auto") указывает, что высота строки определяется автоматически на основе характеристик текущего шрифта. Значение по умолчанию — NaN.

Атрибуты

Исключения

Для LineHeight задано значение, не являющееся положительным.

Примеры

В следующем примере показано, как задать LineHeight атрибут TextBlock элемента.

<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

В следующем примере показано, как программным образом присвоить значение свойству LineHeight.

TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;

Комментарии

Изменение этого значения не приводит к изменению высоты связанного текста; вместо этого изменяется высота строки, содержащей текст. Чтобы изменить размер текста, используйте FontSize свойство .

В дополнение к этому свойству его свойство влияет на LineStackingStrategy макет линий в TextBlock .

Это свойство зависимостей также использует присоединенное свойство. В XAML используется <object TextBlock.LineHeight="value".../>, где object — это объектный элемент (обычно элемент потока), содержащийся в TextBlock, а значение — это строка, как описано в разделе Значения XAML. В коде использование присоединенного свойства поддерживается GetLineHeight и SetLineHeight. Использование присоединенного свойства не распространено.

Использование атрибута XAML

<object LineHeight="double"/>  
- or -  
<object LineHeight="qualifiedDouble"/>  
- or -  
<object LineHeight="Auto"/>  

Значения XAML

double
Double

Строковое представление значения, Double равного или больше, 0.0034 а также равно или меньше .160000 Непроверенное значение измеряется в аппаратно-независимых пикселях. Строки не должны явно включать десятичные знаки.

qualifiedDouble
Двойное значение, как описано выше, (за исключением Auto), за которым следует один из следующих описателей единиц измерения: px, in, cm, pt.

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

in имеет значение в дюймах; 1in==96px

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

pt — очки; 1pt==(96/72) px

Auto (Автоматически)
Определяет высоту строки автоматически на основе текущих характеристик шрифта. Эквивалентно значению Double.NaNсвойства .

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

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

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

Продукт Версии
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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