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 到 160000,以与设备无关的像素为单位。 值 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 属性。

除了此属性之外,中 TextBlock 线条的布局也受其 LineStackingStrategy 属性的影响。

此依赖属性还具有附加属性用法。 在 XAML 中,用法为 <object TextBlock.LineHeight="value".../>,其中 object 是一个对象元素 (通常是包含在 TextBlock中的流元素) , 是 XAML 值中所述的字符串。 在代码中,和 SetLineHeight支持GetLineHeight附加属性用法。 附加属性用法并不常见。

XAML 属性用法

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

XAML 值

double
Double

值等于或大于0.0034且等于 或小于 160000Double字符串表示形式。 非限定值以与设备无关的像素度量。 字符串不需要显式包含小数点。

qualifiedDouble
如上所述的双精度值,除) 后跟下列单位说明符之一外Auto, (:px、、incmpt、 。

px (默认) 为与设备无关的单位, (单位) 1/96 英寸

in 为英寸;1in==96px

cm 为厘米;1cm== (96/2.54) px

pt 是点;1pt== (96/72) px

自动
使行高从当前字体特征自动确定。 等效于 的 Double.NaN属性值。

依赖项属性信息

标识符字段 LineHeightProperty
元数据属性设置为 true AffectsMeasure, AffectsRender, Inherits

适用于

另请参阅