TextFormatter Klas

Definitie

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Overname

Object

TextFormatter

Implementeringen

IDisposable

Voorbeelden

In het volgende voorbeeld ziet u hoe u een TextFormatter object gebruikt om opgemaakte tekstregels te genereren die als tekenobjecten kunnen worden weergegeven.

// 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

Opmerkingen

TextFormatter is de WPF tekstengine die services biedt voor het opmaken van tekst en het verbreken van tekstregels. TextFormatter kan verschillende tekenopmaak en alineastijlen verwerken en bevat ondersteuning voor internationale tekstindelingen.

In tegenstelling tot een traditionele tekst-API communiceert de TextFormatter met een tekstindelingsclient via een set callback-methoden. Hiervoor moet de client deze methoden opgeven in een implementatie van de TextSource-klasse. In het volgende diagram ziet u de interactie van de client voor tekstopmaak en de client voor tekstindeling.

Interactie tussen de client voor tekstindeling en het TextFormatter-object

Services voor tekstopmaak

TextFormatter biedt ondersteuning voor tekstfuncties, zoals OpenType-typografie, evenals ondersteuning voor functies op tekstuitvoering, lijn en alineaniveau.

De volgende tabel is een lijst met de belangrijkste TextFormatter ondersteunde services voor tekstfuncties.

De volgende tabel is een lijst met de belangrijkste TextFormatter ondersteunde services voor functies op alineaniveau.

De volgende tabel is een lijst met de belangrijkste TextFormatter ondersteunde services voor functies op regelniveau.

De volgende tabel is een lijst met de belangrijkste TextFormatter ondersteunde services voor functies op tekstuitvoeringsniveau.

Zie ook

• Voorbeeld van geavanceerde tekstopmaak