TextDecorations Classe

Définition

Fournit un ensemble de décorations de texte statiques prédéfinies.

public ref class TextDecorations abstract sealed
public static class TextDecorations
type TextDecorations = class
Public Class TextDecorations
Héritage
TextDecorations

Exemples

Dans l’exemple suivant, une décoration de texte par frappe utilise la valeur de police par défaut.

// Use the default font values for the strikethrough text decoration.
private void SetDefaultStrikethrough()
{
    // Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough;
}
' Use the default font values for the strikethrough text decoration.
Private Sub SetDefaultStrikethrough()
    ' Set the underline decoration directly to the text block.
    TextBlock1.TextDecorations = TextDecorations.Strikethrough
End Sub
<!-- Use the default font values for the strikethrough text decoration. -->
<TextBlock
  TextDecorations="Strikethrough"
  FontSize="36" >
  The quick red fox
</TextBlock>

Vous pouvez également spécifier plusieurs décorations de texte pour le même texte. Dans l’exemple suivant, une décoration de texte surligne et de soulignement est utilisée pour le même texte.

<!-- Use both an underline and overline text decoration for the same text. -->
<TextBlock TextDecorations="Underline, Overline">
  The quick red fox
</TextBlock>

Vous pouvez utiliser la valeur de chaîne « None » pour indiquer qu’il n’y a pas de décorations de texte dans la TextDecorations collection. Dans l’exemple suivant, la TextDecorations collection est définie sur « None ».

<!-- Set the text decoration collection to None to indicate no decorations. -->
<TextBlock TextDecorations="None">
  The quick red fox
</TextBlock>

Vous pouvez supprimer toutes les décorations de texte du texte à l’aide de la Clear méthode. Dans l’exemple suivant, la TextDecorations collection est effacée.

TextBlock2.TextDecorations.Clear();
TextBlock2.TextDecorations.Clear()

Par défaut, Hyperlink utilise un TextDecoration objet pour afficher un soulignement. L’exemple de balisage suivant montre une Hyperlink définition avec et sans soulignement :

<!-- Hyperlink with default underline. -->
<Hyperlink NavigateUri="http://www.msn.com">
  MSN Home
</Hyperlink>

<Run Text=" | " />

<!-- Hyperlink with no underline. -->
<Hyperlink Name="myHyperlink" TextDecorations="None"
           MouseEnter="OnMouseEnter"
           MouseLeave="OnMouseLeave"
           NavigateUri="http://www.msn.com">
  My MSN
</Hyperlink>

TextDecoration les objets peuvent être gourmands en performances pour instancier, en particulier si vous avez de nombreux Hyperlink objets. Pour plus d’informations, consultez Guide pratique pour spécifier si un lien hypertexte est souligné.

Remarques

Il existe quatre types de décorations de texte : ligne de base, surligne, frappe et soulignement. L’exemple suivant montre les emplacements des décorations de texte par rapport au texte.

Diagramme des emplacements de décoration de texte
Exemple de types de décoration de texte

Utilisation d'attributs XAML

<object textDecorationsProperty="textDecorationType[,textDecorationType]"/>  

Valeurs XAML

textDecorationType
Type de décoration de texte : Baseline, OverLine, Strikethroughou Underline. Plusieurs décorations sont autorisées, avec des valeurs séparées par des virgules. Vous pouvez également spécifier « Aucun » pour indiquer aucun type de décoration de texte.

Propriétés

Baseline

Spécifie une ligne de base TextDecoration.

OverLine

Spécifie une ligne au-dessus TextDecoration.

Strikethrough

Spécifie un TextDecoration barré.

Underline

Spécifie un TextDecoration souligné.

S’applique à