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 サービスの一覧です。

コンストラクター

メソッド

適用対象

こちらもご覧ください

• 高度なテキスト書式設定のサンプル