Dessin du texte mis en forme

Cette rubrique fournit une vue d’ensemble des fonctionnalités de l’objet FormattedText . Cet objet fournit un contrôle de bas niveau pour dessiner du texte dans les applications WPF (Windows Presentation Foundation).

Vue d’ensemble de la technologie

L’objet FormattedText vous permet de dessiner du texte à plusieurs lignes, dans lequel chaque caractère du texte peut être mis en forme individuellement. L’exemple suivant montre un texte auquel plusieurs formats sont appliqués.

Raisons d’utiliser du texte mis en forme

WPF inclut plusieurs contrôles pour dessiner du texte à l’écran. Chaque contrôle est ciblé sur un scénario différent et dispose de sa propre liste de fonctionnalités et limitations. En règle générale, l’élément TextBlock doit être utilisé lorsque la prise en charge limitée du texte est requise, par exemple une brève phrase dans une interface utilisateur. Label peut être utilisé lorsque la prise en charge minimale du texte est requise. Pour plus d’informations, consultez Documents dans WPF.

L’objet FormattedText fournit des fonctionnalités de mise en forme de texte supérieures aux contrôles de texte WPF (Windows Presentation Foundation) et peut être utile dans les cas où vous souhaitez utiliser du texte comme élément décoratif. Pour plus d’informations, consultez la section suivante, Conversion du texte mis en forme en géométrie.

En outre, l’objet FormattedText est utile pour créer des objets dérivés orientés DrawingVisualtexte. DrawingVisual est une classe de dessin légère utilisée pour afficher des formes, des images ou du texte. Pour plus d’informations, consultez Test de positionnement à l’aide de DrawingVisuals, exemple.

Utilisation de l’objet FormattedText

Pour créer du texte mis en forme, appelez le FormattedText constructeur pour créer un FormattedText objet. Une fois que vous avez créé la chaîne initiale de texte mis en forme, vous pouvez appliquer différents styles de mise en forme.

Utilisez la MaxTextWidth propriété pour limiter le texte à une largeur spécifique. Le texte est alors automatiquement renvoyé à la ligne pour éviter de dépasser la largeur spécifiée. Utilisez la MaxTextHeight propriété pour limiter le texte à une hauteur spécifique. Le texte affiche des points de suspension (...) en lieu et place du texte qui dépasse la hauteur spécifiée.

Vous pouvez appliquer plusieurs styles de mise en forme à un ou plusieurs caractères. Par exemple, vous pouvez appeler à la fois les méthodes et SetForegroundBrush les SetFontSize méthodes pour modifier la mise en forme des cinq premiers caractères du texte.

L’exemple de code suivant crée un FormattedText objet, puis applique plusieurs styles de mise en forme au texte.

protected override void OnRender(DrawingContext drawingContext)
{
    string testString = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor";

    // Create the initial formatted text string.
    FormattedText formattedText = new FormattedText(
        testString,
        CultureInfo.GetCultureInfo("en-us"),
        FlowDirection.LeftToRight,
        new Typeface("Verdana"),
        32,
        Brushes.Black);

    // Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300;
    formattedText.MaxTextHeight = 240;

    // Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    // The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

    // Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11);

    // Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(
                            new LinearGradientBrush(
                            Colors.Orange,
                            Colors.Teal,
                            90.0),
                            6, 11);

    // Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28);

    // Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, new Point(10, 0));
}

Protected Overrides Sub OnRender(ByVal drawingContext As DrawingContext)
    Dim testString As String = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor"

    ' Create the initial formatted text string.
    Dim formattedText As New FormattedText(testString, CultureInfo.GetCultureInfo("en-us"), FlowDirection.LeftToRight, New Typeface("Verdana"), 32, Brushes.Black)

    ' Set a maximum width and height. If the text overflows these values, an ellipsis "..." appears.
    formattedText.MaxTextWidth = 300
    formattedText.MaxTextHeight = 240

    ' Use a larger font size beginning at the first (zero-based) character and continuing for 5 characters.
    ' The font size is calculated in terms of points -- not as device-independent pixels.
    formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5)

    ' Use a Bold font weight beginning at the 6th character and continuing for 11 characters.
    formattedText.SetFontWeight(FontWeights.Bold, 6, 11)

    ' Use a linear gradient brush beginning at the 6th character and continuing for 11 characters.
    formattedText.SetForegroundBrush(New LinearGradientBrush(Colors.Orange, Colors.Teal, 90.0), 6, 11)

    ' Use an Italic font style beginning at the 28th character and continuing for 28 characters.
    formattedText.SetFontStyle(FontStyles.Italic, 28, 28)

    ' Draw the formatted text string to the DrawingContext of the control.
    drawingContext.DrawText(formattedText, New Point(10, 0))
End Sub

Unité de mesure de la taille de police

Comme avec d’autres objets texte dans les applications WPF (Windows Presentation Foundation), l’objet utilise des pixels indépendants de l’appareil FormattedText comme unité de mesure. Toutefois, la plupart des applications Win32 utilisent des points comme unité de mesure. Si vous souhaitez utiliser du texte d’affichage en unités de points dans les applications WPF (Windows Presentation Foundation), vous devez convertir des unités indépendantes de l’appareil (1/96e pouce par unité) en points. L’exemple de code suivant montre comment effectuer cette conversion.

// The font size is calculated in terms of points -- not as device-independent pixels.
formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5);

' The font size is calculated in terms of points -- not as device-independent pixels.
formattedText.SetFontSize(36 * (96.0 / 72.0), 0, 5)

Conversion du texte mis en forme en géométrie

Vous pouvez convertir du texte mis en forme en Geometry objets, ce qui vous permet de créer d’autres types de texte visuellement intéressants. Par exemple, vous pouvez créer un Geometry objet en fonction du contour d’une chaîne de texte.

Les exemples suivants illustrent plusieurs façons de créer des effets visuels intéressants en modifiant le trait, le remplissage et la surbrillance du texte converti.

Lorsque le texte est converti en Geometry objet, il ne s’agit plus d’une collection de caractères. Vous ne pouvez pas modifier les caractères de la chaîne de texte. Vous pouvez néanmoins modifier l’apparence du texte converti en changeant ses propriétés de trait et de remplissage. Le trait fait référence au contour du texte converti et le remplissage à la zone située à l’intérieur du contour du texte converti. Pour plus d’informations, consultez Créer du texte avec contour.

Vous pouvez également convertir du texte mis en forme en objet PathGeometry et utiliser l’objet pour mettre en surbrillance le texte. Par exemple, vous pouvez appliquer une animation à l’objet PathGeometry afin que l’animation suit le contour du texte mis en forme.

L’exemple suivant montre le texte mis en forme qui a été converti en objet PathGeometry . Une ellipse animée suit le tracé des traits du texte rendu.

Sphère suivant la géométrie de tracé du texte

Pour plus d’informations, consultez Guide pratique pour créer une animation PathGeometry pour du texte.

Vous pouvez créer d’autres utilisations intéressantes pour le texte mis en forme une fois qu’il a été converti en objet PathGeometry . Par exemple, vous pouvez y insérer une vidéo.

Migration depuis Win32

Les fonctionnalités du texte de FormattedText dessin sont similaires aux caractéristiques de la fonction DrawText Win32. Pour les développeurs qui migrent à partir de l’API Win32, le tableau suivant répertorie les indicateurs DrawText Win32 et l’équivalent approximatif dans WPF (Windows Presentation Foundation).

Voir aussi

• FormattedText
• Documents dans WPF
• Typographie dans WPF
• Créer du texte avec contour
• Guide pratique pour créer une animation PathGeometry pour du texte