TextBlock.LineHeight Propiedad

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Obtiene o establece el alto de cada línea de contenido.

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

Valor de propiedad

Double

Alto de línea, en píxeles independientes del dispositivo, en el intervalo de 0,0034 a 160000. Un valor de NaN (equivalente a un valor de atributo de "Auto") indica que el alto de línea se determina automáticamente a partir de las características de fuente actuales. El valor predeterminado es NaN.

Atributos

TypeConverterAttribute

Excepciones

ArgumentException

LineHeight se establece en un valor no positivo.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el LineHeight atributo de un TextBlock elemento .

<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>

En el ejemplo siguiente se muestra cómo establecer la LineHeight propiedad mediante programación.

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

Comentarios

Cambiar este valor no cambia el alto del texto asociado; en su lugar, cambia el alto de la línea que contiene el texto. Para cambiar el tamaño del texto, use la FontSize propiedad .

Además de esta propiedad, el diseño de las líneas de un TextBlock objeto se ve afectado por su LineStackingStrategy propiedad .

Esta propiedad de dependencia también tiene un uso de propiedad adjunta. En XAML, el uso es , donde el objeto es <object TextBlock.LineHeight="value".../>un elemento de objeto (normalmente un elemento de flujo) contenido en un TextBlock, y el valor es una cadena como se explica en Valores XAML. En el código, el uso de la propiedad adjunta es compatible con GetLineHeight y SetLineHeight. El uso de la propiedad adjunta no es común.

Uso de atributos XAML

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

Valores XAML

doubleDouble

Representación de cadena de un Double valor igual o mayor 0.0034 que y igual que o menor que .160000 Un valor no calificado se mide en píxeles independientes del dispositivo. Las cadenas no necesitan incluir explícitamente puntos decimales.

qualifiedDouble Valor doble como se ha descrito anteriormente( excepto Auto) seguido de uno de los siguientes especificadores de unidad: px, in, cm, pt.

px (valor predeterminado) es unidades independientes del dispositivo (1/96 pulgadas por unidad)

in es pulgadas; 1in==96px

cm es centímetros; 1cm==(96/2.54) px

pt es puntos; 1pt==(96/72) px

Auto Hace que el alto de línea se determine automáticamente a partir de las características de fuente actuales. Equivalente a un valor de propiedad de Double.NaN.

Información de la propiedad dependency

Elemento	Importancia
Campo identificador	LineHeightProperty
Propiedades de metadatos establecidas en true	AffectsMeasure, , AffectsRender, Inherits

Consulte también

• LineHeight