TextBlock.LineHeight Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 |