TextBlock.LineHeight Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft die Höhe jeder Inhaltszeile ab bzw. legt diese 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

Double

Die Höhe der Zeilen in geräteunabhängigen Pixeln im Bereich von 0,0034 bis 160000. Beim Wert NaN (entspricht dem Attributwert „Auto“) wird die Zeilenhöhe automatisch anhand der aktuellen Schriftartmerkmale bestimmt. Der Standardwert lautet NaN.

Attribute

TypeConverterAttribute

Ausnahmen

ArgumentException

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 Sie die LineHeight-Eigenschaft programmatisch einstellen können.

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

Wenn Sie diesen Wert ändern, wird die Höhe des zugeordneten Texts nicht geändert. stattdessen wird die Höhe der Zeile geändert, die den Text enthält. Verwenden Sie die -Eigenschaft, um die FontSize Größe des Texts zu ändern.

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

Diese Abhängigkeitseigenschaft verfügt auch über eine angefügte Eigenschaftsverwendung. In XAML ist <object TextBlock.LineHeight="value".../>die Verwendung , wobei object ein Objektelement (in der Regel ein Flowelement) ist, das in einem TextBlockenthalten ist, und wert eine Zeichenfolge ist, wie in XAML-Werte erläutert. Im Code wird die Verwendung angefügter Eigenschaften von GetLineHeight und SetLineHeightunterstützt. 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

double
Double

Zeichenfolgendarstellung eines Double Werts gleich oder größer als 0.0034 und gleich oder kleiner als 160000. Ein nicht qualifizierter Wert wird in geräteunabhängigen Pixeln gemessen. Zeichenfolgen müssen nicht explizit Dezimalstellen enthalten.

qualifiedDouble
Ein doppelter Wert wie oben beschrieben (außer Auto), gefolgt von einem der folgenden Einheitenspezifizierer: px, in, cm, 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

Automatisch
Bewirkt, dass die Linienhöhe automatisch aus den aktuellen Schriftartmerkmalen bestimmt wird. Entspricht einem -Eigenschaftswert von Double.NaN.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	LineHeightProperty
Metadateneigenschaften auf true festgelegt	AffectsMeasure, AffectsRender, Inherits

Weitere Informationen

• LineHeight