TextFormatter Klass

Definition

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Arv

Object

TextFormatter

Implementeringar

IDisposable

Exempel

I följande exempel visas hur du använder ett TextFormatter objekt för att generera formaterade textrader som kan visas som ritade objekt.

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

Kommentarer

TextFormatter är den WPF textmotorn som tillhandahåller tjänster för formatering av text och icke-bakåtkompatibla textrader. TextFormatter kan hantera olika textteckenformat och styckeformat och innehåller stöd för internationell textlayout.

Till skillnad från ett traditionellt text-API interagerar TextFormatter med en textlayoutklient via en uppsättning återanropsmetoder. Det kräver att klienten tillhandahåller dessa metoder i en implementering av klassen TextSource. Följande diagram illustrerar interaktionen mellan textformateringsklienten och textlayoutklienten.

Interaktion mellan textlayoutklienten och TextFormatter-objektet

Textformateringstjänster

TextFormatter ger stöd för textfunktioner, till exempel OpenType-typografi, samt stöd för textkörning, rad- och styckenivåfunktioner.

Följande tabell är en lista över de viktiga TextFormatter tjänster som stöds för textfunktioner.

Följande tabell är en lista över de viktiga TextFormatter tjänster som stöds för funktioner på styckenivå.

Följande tabell är en lista över de viktiga TextFormatter tjänster som stöds för funktioner på radnivå.

Följande tabell är en lista över de viktiga TextFormatter tjänster som stöds för funktioner på textkörningsnivå.

Se även

• Exempel på avancerad textformatering