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 seguinte mostra como usar um TextFormatter objeto para gerar linhas de texto formatadas que podem ser apresentadas 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

Observações

TextFormatter é o motor de texto WPF que fornece serviços para formatar texto e quebrar linhas de texto. TextFormatter Pode lidar com diferentes formatos de caracteres de texto e estilos de parágrafo, e inclui suporte para layout de texto internacional.

Ao contrário de uma API de texto tradicional, o TextFormatter interage com um cliente de layout de texto através de um conjunto de métodos de chamada de retorno. Ele requer que o cliente forneça esses métodos em uma implementação da classe TextSource. O diagrama seguinte ilustra a interação entre o cliente de formatador de texto e o 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 funcionalidades de texto, como tipografia OpenType, bem como suporte para funcionalidades de execução, linha e nível de parágrafo.

A tabela seguinte é uma lista dos principais TextFormatter serviços suportados para funcionalidades de texto.

A tabela seguinte apresenta uma lista dos principais TextFormatter serviços suportados para funcionalidades ao nível do parágrafo.

A tabela seguinte é uma lista dos principais TextFormatter serviços suportados para funcionalidades ao nível de linha.

A tabela seguinte apresenta uma lista dos principais TextFormatter serviços suportados para funcionalidades ao nível da execução de texto.

Ver também

• Exemplo Avançado de Formatação de Texto