TextBlock.LineHeight Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

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

public:
 property double LineHeight { double get(); void set(double value); };

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

[<System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))>]
member this.LineHeight : double with get, set

Public Property LineHeight As Double

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

Double

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

Атрибуты

TypeConverterAttribute

Исключения

ArgumentException

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;

Dim textBlock As 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 свойство.

Помимо этого свойства, макет строк в объекте TextBlock зависит от его LineStackingStrategy свойства.

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

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

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

Значения XAML

ДвухместныйDouble

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

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

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

in имеет дюймы; 1in==96px

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

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

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

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

Элемент	Ценность
Поле идентификатора	LineHeightProperty
Свойства метаданных, равные свойству true	AffectsMeasure, AffectsRender, Inherits

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

• LineHeight