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 "Auto") indica que a altura da linha é determinada automaticamente pelas características da fonte atual. O padrão é NaN.

Atributos

TypeConverterAttribute

Exceções

ArgumentException

LineHeight é definida 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 LineHeight propriedade 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 anexado. No XAML, o uso é <object TextBlock.LineHeight="value".../>, em que o objeto é um elemento de objeto (normalmente um elemento de fluxo) contido em um TextBlocke o valor é uma cadeia de caracteres, conforme explicado em Valores XAML. No código, o uso da propriedade anexada é compatível com 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

double
Double

Representação de cadeia de caracteres de um Double valor igual ou maior que 0.0034 e igual a ou menor 160000que . 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

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 de dependência

Campo Identificador	LineHeightProperty
Propriedades de metadados definidas como true	AffectsMeasure, AffectsRender, Inherits

Confira também

• LineHeight