Freigeben über


TextBlock.LineHeight Eigenschaft

Definition

Ruft die Höhe jeder Inhaltszeile ab oder legt sie fest.

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

Eigenschaftswert

Die Höhe der Linie in unabhängigen Pixeln des Geräts im Bereich von 0,0034 bis 160000. Ein Wert von NaN (entspricht einem Attributwert von "Auto") gibt an, dass die Zeilenhöhe automatisch von den aktuellen Schriftartmerkmalen bestimmt wird. Der Standardwert lautet NaN.

Attribute

Ausnahmen

LineHeight wird auf einen nicht positiven Wert festgelegt.

Beispiele

Das folgende Beispiel zeigt, wie das LineHeight Attribut eines TextBlock Elements festgelegt wird.

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

Das folgende Beispiel zeigt, wie die LineHeight-Eigenschaft programmgesteuert festgelegt wird.

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

Hinweise

Durch Ändern dieses Werts wird die Höhe des zugeordneten Texts nicht geändert. Stattdessen ändert sie die Höhe der Zeile, die den Text enthält. Verwenden Sie die FontSize Eigenschaft, um die Größe des Texts zu ändern.

Zusätzlich zu dieser Eigenschaft wird das Layout von Linien in einer TextBlock Eigenschaft beeinflusst LineStackingStrategy .

Diese Abhängigkeitseigenschaft verfügt auch über eine angefügte Eigenschaftsnutzung. In XAML ist <object TextBlock.LineHeight="value".../>die Verwendung , wobei objekt ein Objektelement (in der Regel ein Flusselement) in einem TextBlock, und Wert eine Zeichenfolge ist, wie in XAML-Werten erläutert. Im Code wird die Verwendung angefügter Eigenschaften von GetLineHeight und SetLineHeight. Die Verwendung angefügter Eigenschaften ist nicht üblich.

Verwendung von XAML-Attributen

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

XAML-Werte

DoppelDouble

Zeichenfolgendarstellung eines Double Werts gleich oder größer als 0.0034 und gleich oder kleiner dann 160000. Ein nicht qualifizierter Wert wird in unabhängigen Pixeln des Geräts gemessen. Zeichenfolgen müssen keine dezimalen Punkte enthalten.

qualifiedDouble Ein doppelter Wert wie oben beschrieben, (mit Ausnahme Auto) gefolgt von einem der folgenden Einheitenbezeichner: px, , , incm. pt

px (Standard) ist geräteunabhängige Einheiten (1/96. Zoll pro Einheit)

in ist Zoll; 1in==96px

cm ist Zentimeter; 1cm==(96/2,54) px

pt ist Punkte; 1pt==(96/72) px

Die Zeilenhöhe wird automatisch anhand der aktuellen Schriftartmerkmale bestimmt. Entspricht einem Eigenschaftswert von Double.NaN.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld LineHeightProperty
Auf Metadateneigenschaften festgelegt true AffectsMeasure, AffectsRenderInherits

Gilt für:

Weitere Informationen