TextBlock.LineHeight Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает высоту каждой строки содержимого.
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
Значение свойства
Высота строки в аппаратно-независимых пикселях в диапазоне от 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;
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 свойство .
В дополнение к этому свойству его свойство влияет на 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 |