TextBlock.LineHeight Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtém ou define a altura de cada linha de conteúdo.

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

Double

A altura da linha, em pixels independentes do dispositivo, no intervalo de 0,0034 a 160000. Um valor ( NaN equivalente a um valor de atributo de "Auto") indica que a altura da linha é determinada automaticamente a partir das características atuais da fonte. O padrão é NaN.

Atributos

TypeConverterAttribute

Exceções

ArgumentException

LineHeight é definido como um valor não positivo.

Exemplos

O exemplo a seguir mostra como definir o LineHeight atributo de um 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>

O exemplo a seguir mostra como definir a propriedade LineHeight programaticamente.

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

Comentários

Alterar esse valor não altera a altura do texto associado; em vez disso, altera a altura da linha que contém o texto. Para alterar o tamanho do texto, use a FontSize propriedade.

Além dessa propriedade, o layout das linhas em um TextBlock é afetado por sua LineStackingStrategy propriedade.

Essa propriedade de dependência também tem um uso de propriedade anexada. No XAML, o uso é <object TextBlock.LineHeight="value".../>, em que o objeto é um elemento de objeto (normalmente um elemento de fluxo) contido em um TextBlock, e o valor é uma cadeia de caracteres, conforme explicado em Valores XAML. No código, o uso da propriedade anexada tem suporte GetLineHeight e SetLineHeight. O uso da propriedade anexada não é comum.

Uso do atributo XAML

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

Valores XAML

DuploDouble

Representação de cadeia de caracteres de um Double valor igual ou maior que 0.0034 e igual ou menor a.160000 Um valor não qualificado é medido em pixels independentes do dispositivo. As cadeias de caracteres não precisam incluir explicitamente pontos decimais.

Qualifieddouble Um valor duplo conforme descrito acima, (exceto Auto) seguido por um dos seguintes especificadores de unidade: px, , in, cm. pt

px (padrão) são unidades independentes do dispositivo (1/96 polegada por unidade)

in é polegadas; 1in==96px

cm é centímetros; 1cm==(96/2,54) px

pt é pontos; 1pt==(96/72) px

O auto faz com que a altura da linha seja determinada automaticamente a partir das características atuais da fonte. Equivalente a um valor de propriedade de Double.NaN.

Informações da propriedade Dependency

Item	Valor
Campo identificador	LineHeightProperty
Propriedades de metadados definidas como true	AffectsMeasure, , AffectsRenderInherits

Confira também

• LineHeight