TextFormatter Classe

Définition

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Héritage

Object

TextFormatter

Implémente

IDisposable

Exemples

L’exemple suivant montre comment utiliser un TextFormatter objet pour générer des lignes de texte mises en forme qui peuvent être affichées en tant qu’objets de dessin.

// Create a TextFormatter object.
TextFormatter formatter = TextFormatter.Create();

// Create common paragraph property settings.
CustomTextParagraphProperties customTextParagraphProperties
    = new CustomTextParagraphProperties();

// Format each line of text from the text store and draw it.
while (textStorePosition < customTextSource.Text.Length)
{
    // Create a textline from the text store using the TextFormatter object.
    using (TextLine myTextLine = formatter.FormatLine(
        customTextSource,
        textStorePosition,
        96 * 6,
        customTextParagraphProperties,
        null))
    {
        // Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None);

        // Update the index position in the text store.
        textStorePosition += myTextLine.Length;

        // Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height;
    }
}

' Create a TextFormatter object.
Dim formatter As TextFormatter = TextFormatter.Create()

' Create common paragraph property settings.
Dim customTextParagraphProperties As New CustomTextParagraphProperties()

' Format each line of text from the text store and draw it.
Do While textStorePosition < customTextSource.Text.Length
    ' Create a textline from the text store using the TextFormatter object.
    Using myTextLine As TextLine = formatter.FormatLine(customTextSource, textStorePosition, 96 * 6, customTextParagraphProperties, Nothing)
        ' Draw the formatted text into the drawing context.
        myTextLine.Draw(drawingContext, linePosition, InvertAxes.None)

        ' Update the index position in the text store.
        textStorePosition += myTextLine.Length

        ' Update the line position coordinate for the displayed line.
        linePosition.Y += myTextLine.Height
    End Using
Loop

Remarques

TextFormatter est le moteur de texte WPF qui fournit des services pour mettre en forme du texte et briser des lignes de texte. TextFormatter peut gérer différents formats de caractères de texte et styles de paragraphe, et inclut la prise en charge de la disposition de texte internationale.

Contrairement à une API de texte traditionnelle, l’interaction TextFormatter avec un client de disposition de texte via un ensemble de méthodes de rappel. Il nécessite que le client fournisse ces méthodes dans une implémentation de la TextSource classe. Le diagramme suivant illustre l’interaction du client de formateur de texte et du client de disposition de texte.

Interaction entre le client de disposition de texte et l’objet TextFormatter

Services de mise en forme de texte

TextFormatter prend en charge les fonctionnalités de texte, telles que la typographie OpenType, ainsi que la prise en charge des fonctionnalités d’exécution de texte, de ligne et de paragraphe.

Le tableau suivant est une liste des services pris en charge par les clés TextFormatter pour les fonctionnalités de texte.

Le tableau suivant est une liste des services pris en charge clés TextFormatter pour les fonctionnalités au niveau du paragraphe.

Le tableau suivant est une liste des services pris en charge clés TextFormatter pour les fonctionnalités au niveau de la ligne.

Le tableau suivant est une liste des services pris en charge par les clés TextFormatter pour les fonctionnalités au niveau de l’exécution de texte.

Constructeurs

Méthodes

S’applique à

Voir aussi

• Exemple de mise en forme de texte avancé