TextBlock.LineHeight Propiedad

Definición

Obtiene o establece el alto de cada línea de contenido.Gets or sets the height of each line of content.

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.The height of line, in device independent pixels, in the range of 0.0034 to 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 la fuente actual.A value of NaN (equivalent to an attribute value of "Auto") indicates that the line height is determined automatically from the current font characteristics. De manera predeterminada, es NaN.The default is NaN.

Atributos

Excepciones

LineHeight se establece en un valor no positivo.LineHeight is set to a non-positive value.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer el LineHeight atributo de un TextBlock elemento.The following example shows how to set the LineHeight attribute of a TextBlock element.

<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.The following example shows how to set the LineHeight property programmatically.

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

Al cambiar este valor, no se cambia el alto del texto asociado; en su lugar, cambia el alto de la línea que contiene el texto.Changing this value does not change the height of the associated text; rather, it changes the height of the line that contains the text. Para cambiar el tamaño del texto, use la FontSize propiedad.To change the size of the text, use the FontSize property.

Además de esta propiedad, el diseño de las líneas de un TextBlock se ve afectado por su LineStackingStrategy propiedad.In addition to this property, the layout of lines in a TextBlock is affected by its LineStackingStrategy property.

Esta propiedad de dependencia también tiene un uso de la propiedad adjunta.This dependency property also has an attached property usage. En XAML, el uso es <object TextBlock.LineHeight="value".../> , donde el objeto es un elemento de objeto (normalmente un elemento de flujo) contenido dentro de un TextBlock , y el valor es una cadena, tal y como se explica en valores XAML.In XAML, the usage is <object TextBlock.LineHeight="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is a string as explained in XAML Values. En el código, el uso de la propiedad adjunta es compatible con GetLineHeight y SetLineHeight .In code, the attached property usage is supported by GetLineHeight and SetLineHeight. El uso de la propiedad adjunta no es habitual.The attached property usage is not common.

Uso de atributos XAMLXAML Attribute Usage

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

Valores XAMLXAML Values

doubledouble
Double

Representación de cadena de un Double valor igual o mayor que 0.0034 e igual o menor que 160000 .String representation of a Double value equal to or greater than 0.0034 and equal to or less then 160000. Un valor no calificado se mide en píxeles independientes del dispositivo.An unqualified value is measured in device independent pixels. Las cadenas no deben incluir explícitamente los puntos decimales.Strings need not explicitly include decimal points.

qualifiedDoublequalifiedDouble
Un valor Double tal y como se ha descrito anteriormente, (excepto Auto ) seguido de uno de los siguientes especificadores de unidad: px , in , cm , pt .A double value as described above, (excepting Auto) followed by one of the following unit specifiers: px, in, cm, pt.

px (valor predeterminado) son unidades independientes del dispositivo (1/1/96 pulgada por unidad)px (default) is device-independent units (1/96th inch per unit)

in es pulgadas; 1in = =, 96 PXin is inches; 1in==96px

cm es centímetros; 1cm = = (96/2,54) PXcm is centimeters; 1cm==(96/2.54) px

pt es un punto; 1PT. = = (96/72) PXpt is points; 1pt==(96/72) px

AutoAuto
Hace que el alto de línea se determine automáticamente a partir de las características de la fuente actual.Causes the line height to be determined automatically from the current font characteristics. Equivalente a un valor de propiedad de Double.NaN .Equivalent to a property value of Double.NaN.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field LineHeightProperty
Propiedades de metadatos establecidas en trueMetadata properties set to true AffectsMeasure, AffectsRender, InheritsAffectsMeasure, AffectsRender, Inherits

Se aplica a

Consulte también