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

El alto de línea, en píxeles independientes del dispositivo, en el intervalo de 0.0034 a 160 000. 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 la fuente actual. 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 propiedad LineHeight 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 <object TextBlock.LineHeight="value".../>, donde object es un elemento de objeto (normalmente un elemento flow) contenido en un TextBlock, y value 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

double
Double

Representación de cadena de un Double valor igual o mayor 0.0034 que y igual que o menor que .160000 Un valor no completo 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 sobre propiedades de dependencia

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

Consulte también

• LineHeight