TextFormatter Класс

Определение

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Наследование

Object

TextFormatter

Реализации

IDisposable

Примеры

В следующем примере показано, как использовать TextFormatter объект для создания форматированных строк текста, которые могут отображаться как объекты рисования.

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

Комментарии

TextFormatter — это обработчик текста WPF, который предоставляет службы для форматирования текста и критических текстовых строк. TextFormatter может обрабатывать различные форматы текстовых символов и стили абзацев и содержать поддержку международного макета текста.

В отличие от традиционного API текста, TextFormatter взаимодействует с клиентом макета текста с помощью набора методов обратного вызова. Клиенту требуется предоставить эти методы в реализации класса TextSource. На следующей схеме показано взаимодействие клиента форматирования текста и клиента макета текста.

Взаимодействие между клиентом макета текста и объектом TextFormatter

Службы форматирования текста

TextFormatter предоставляет поддержку текстовых функций, таких как типография OpenType, а также поддержку функций на уровне текста, строки и абзаца.

В следующей таблице приведен список ключевых TextFormatter поддерживаемых служб для текстовых функций.

В следующей таблице приведен список ключевых TextFormatter поддерживаемых служб для функций уровня абзаца.

В следующей таблице приведен список ключевых TextFormatter поддерживаемых служб для функций уровня строки.

В следующей таблице приведен список ключевых TextFormatter поддерживаемых служб для функций текстового уровня выполнения.

См. также раздел

• Пример расширенного форматирования текста