TextFormatter Classe

Definição

public ref class TextFormatter abstract : IDisposable

public abstract class TextFormatter : IDisposable

type TextFormatter = class
    interface IDisposable

Public MustInherit Class TextFormatter
Implements IDisposable

Herança

Object

TextFormatter

Implementações

IDisposable

Exemplos

O exemplo a seguir mostra como usar um TextFormatter objeto para gerar linhas formatadas de texto que podem ser exibidas como objetos de desenho.

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

Comentários

TextFormatter é o mecanismo de texto do WPF que fornece serviços para formatação de texto e quebra de linhas de texto. TextFormatter pode lidar com diferentes formatos de caractere de texto e estilos de parágrafo e inclui suporte para layout de texto internacional.

Ao contrário de uma API de texto tradicional, a TextFormatter interação com um cliente de layout de texto por meio de um conjunto de métodos de retorno de chamada. Ele requer que o cliente forneça esses métodos em uma implementação da TextSource classe. O diagrama a seguir ilustra a interação do cliente do formatador de texto e do cliente de layout de texto.

Interação entre o cliente de layout de texto e o objeto TextFormatter

Serviços de Formatação de Texto

TextFormatter fornece suporte para recursos de texto, como tipografia OpenType, bem como suporte para recursos de execução de texto, linha e nível de parágrafo.

A tabela a seguir é uma lista dos principais TextFormatter serviços com suporte para recursos de texto.

A tabela a seguir é uma lista dos principais TextFormatter serviços com suporte para recursos de nível de parágrafo.

A tabela a seguir é uma lista dos principais TextFormatter serviços com suporte para recursos de nível de linha.

A tabela a seguir é uma lista dos principais TextFormatter serviços com suporte para recursos de nível de execução de texto.

Construtores

Métodos

Aplica-se a

Confira também

• Exemplo avançado de formatação de texto