TextBlock.LineHeight Propriété

Définition

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é

Hauteur de ligne en dip (device independent pixel) dans la plage de valeurs comprises entre 0,0034 et 160 000. La valeur NaN (équivalente à une valeur d’attribut «Auto») indique que la hauteur de ligne est déterminée automatiquement à partir des caractéristiques de la police actuelle. Par défaut, il s’agit de NaN.

Attributs

Exceptions

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é ; au lieu de cela, il modifie 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 d’un TextBlock est affectée par sa LineStackingStrategy propriété.

Cette propriété de dépendance a également une utilisation de propriété jointe. En XAML, l’utilisation est <object TextBlock.LineHeight="value".../>, où object 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 de la propriété jointe est prise en charge par GetLineHeight et SetLineHeight. L’utilisation de la propriété jointe n’est pas courante.

Utilisation d'attributs XAML

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

Valeurs XAML

double
Double

Représentation sous forme de chaîne d’une Double valeur égale ou supérieure 0.0034 à et é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 des décimales.

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

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

in est en pouces; 1in==96px

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

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

Auto
Entraîne la détermination automatique de la hauteur de ligne à partir des caractéristiques de police actuelles. Équivalent à une valeur de propriété de Double.NaN.

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

Champ Identificateur LineHeightProperty
Propriétés de métadonnées définies sur true AffectsMeasure, AffectsRender, Inherits

S’applique à

Voir aussi