TextBlock.LineHeight Propriété

Référence

Définition

Espace de noms:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 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: 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é ; 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

LineHeight

Partager via