TextBlock.LineHeight Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit la hauteur de chaque ligne de contenu.

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

Valeur de propriété

Double

Hauteur de ligne, en pixels indépendants de l’appareil, comprise entre 0,0034 et 16 0000. La valeur NaN (équivalente à une valeur d’attribut de «Auto ») indique que la hauteur de ligne est déterminée automatiquement à partir des caractéristiques de police actuelles. La valeur par défaut est NaN.

Attributs

TypeConverterAttribute

Exceptions

ArgumentException

LineHeight est défini sur une valeur non positive.

Exemples

L’exemple suivant montre comment définir l’attribut LineHeight d’un TextBlock élément.

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

L’exemple suivant montre comment définir la LineHeight propriété par programmation.

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

Remarques

La modification de cette valeur ne modifie pas la hauteur du texte associé ; il modifie plutôt la hauteur de la ligne qui contient le texte. Pour modifier la taille du texte, utilisez la FontSize propriété.

En plus de cette propriété, la disposition des lignes dans un TextBlock est affectée par sa LineStackingStrategy propriété.

Cette propriété de dépendance a également une utilisation des propriétés jointes. En XAML, l’utilisation est <object TextBlock.LineHeight="value".../>, où l’objet est un élément d’objet (généralement un élément de flux) contenu dans un TextBlock, et la valeur est une chaîne, comme expliqué dans Valeurs XAML. Dans le code, l’utilisation des propriétés jointes est prise en charge par GetLineHeight et SetLineHeight. L’utilisation des propriétés jointes n’est pas courante.

Utilisation des attributs XAML

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

Valeurs XAML

DoubleDouble

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure 0.0034 ou égale à ou inférieure.160000 Une valeur non qualifiée est mesurée en pixels indépendants de l’appareil. Les chaînes n’ont pas besoin d’inclure explicitement les décimales.

qualifiedDouble Valeur double comme décrit ci-dessus, (à l’exception Auto) suivie de l’un des spécificateurs d’unités suivants : px, , in, cmpt.

px (valeur par défaut) est des unités indépendantes de l’appareil (1/96e pouce par unité)

in est pouces ; 1in==96px

cm est en centimètres ; 1cm==(96/2.54) px

pt est des points ; 1pt==(96/72) px

La hauteur de ligne est déterminée automatiquement à partir des caractéristiques de police actuelles. Équivaut à une valeur de propriété de Double.NaN.

Informations sur les propriétés de dépendance

Élément	Valeur
Champ d’identificateur	LineHeightProperty
Propriétés de métadonnées définies sur true	AffectsMeasure, , AffectsRenderInherits

Voir aussi

• LineHeight