テキストの高度な書式設定

更新 : 2007 年 11 月

Windows Presentation Foundation (WPF) には、アプリケーションにテキストを含めるための堅牢な一連の API が用意されています。TextBlock などのレイアウトおよびユーザー インターフェイス (UI)API は、テキスト表示において最も共通して一般的に使用される要素を提供します。GlyphRunDrawing や FormattedText などの描画 API では、書式設定されたテキストを描画に含めることができます。最も高度なレベルでは、WPF により、テキスト ストアの管理、テキスト ランの書式設定の管理、埋め込みオブジェクトの管理などの、テキスト表示のあらゆる面の制御を行う拡張性のあるテキスト書式設定エンジンが提供されます。

ここでは、WPF におけるテキスト書式設定の概要を説明します。特に、クライアントの実装と WPF のテキスト書式設定エンジンの使用を重点的に説明します。

メモ :
このドキュメント内のすべてのコード例は、「テキストの高度な書式設定のサンプル」にあります)。

このトピックには次のセクションが含まれています。

• 必要条件
• テキストの高度な書式設定
• テキスト フォーマッタの使用
• クライアント テキスト ストアの実装
• テキスト ランの提供
• 書式設定プロパティの指定
• 関連トピック

必要条件

ここでは、テキスト表示に使用する高いレベルの API に精通していることを前提として説明を進めます。ほとんどのユーザーの場合、ここで説明する API の高度なテキスト書式設定は必要ありません。別のテキスト API の概要については、「Windows Presentation Foundation のドキュメント」を参照してください。

テキストの高度な書式設定

WPF のテキスト レイアウトおよび UI コントロールは、アプリケーションに書式設定されたテキストを簡単に含めることができる書式設定プロパティを提供します。これらのコントロールは、テキストの書体、サイズ、色などのテキスト表示を処理するためのさまざまなプロパティを公開します。通常の場合は、これらのコントロールでアプリケーション内のテキスト表示の大半を処理できます。ただし、一部の高度な処理の場合、テキスト表示に加えてテキスト保存も必要となります。そのような場合のために、WPF では拡張可能なテキスト書式設定エンジンを使用できます。

WPF の高度なテキスト書式設定機能は、テキスト書式設定エンジン、テキスト ストア、テキスト ラン、および書式設定プロパティで構成されています。テキスト書式設定エンジンである TextFormatter により、表示用のテキスト行が作成されます。これは、行書式設定プロセスを開始し、テキスト フォーマッタの FormatLine を呼び出すことにより実行されます。テキスト フォーマッタは、そのストアの GetTextRun メソッドを呼び出すことにより、テキスト ストアからテキスト ランを取得します。次に、テキスト フォーマッタにより TextRun オブジェクトから TextLine オブジェクトが作成され、検査または表示用にアプリケーションに渡されます。

テキスト フォーマッタの使用

TextFormatter は WPF のテキスト書式設定エンジンであり、テキスト行の書式指定および改行のサービスを提供します。テキスト フォーマッタは異なるテキスト文字形式および段落スタイルを処理でき、国際的なテキスト レイアウトがサポートされています。

従来のテキスト API とは異なり、TextFormatter は一連のコールバック メソッドを使用して、テキスト レイアウト クライアントと対話します。このテキスト フォーマッタを使用するには、クライアントが TextSource クラスの実装にこれらのメソッドを提供している必要があります。クライアント アプリケーションと TextFormatter の間のテキスト レイアウトの対話を次の図に示します。

アプリケーションと TextFormatter の対話

テキスト フォーマッタは、TextSource の実装であるテキスト ストアから書式設定されたテキスト行を取得するために使用されます。これは、最初に Create メソッドを使用してテキスト フォーマッタのインスタンスを作成することにより実行されます。このメソッドによりテキスト フォーマッタのインスタンスが作成され、行の最大高と最大幅が設定されます。テキスト フォーマッタのインスタンスが作成されると直ちに、FormatLine メソッドを呼び出すことにより、行作成プロセスが開始されます。TextFormatter によりテキストのソースが呼び戻され、行を形成する一続きのテキストの、テキストと書式設定パラメータが取得されます。

次の例では、テキスト ストアを書式設定するプロセスを示します。TextFormatter オブジェクトを使用してテキスト ストアからテキスト行が取得され、DrawingContext に描画するテキスト行が書式設定されます。

クライアント テキスト ストアの実装

テキスト書式設定エンジンを拡張する場合は、テキスト ストアをすべての面で実装および管理する必要があります。これは単純な作業ではありません。テキスト ストアの役割は、テキスト ランのプロパティ、段落プロパティ、埋め込みオブジェクト、およびその他の類似したコンテンツを追跡することです。また、テキスト ストアは、TextLine オブジェクトを作成するときにテキスト フォーマッタが使用する、個々の TextRun オブジェクトをテキスト フォーマッタに提供します。

テキスト ストアの仮想化を処理する場合は、テキスト ストアが TextSource から派生している必要があります。TextSource では、テキスト フォーマッタがテキスト ストアからテキスト ランを取得するために使用するメソッドが定義されています。GetTextRun は、行の書式設定に使用されるテキスト ランを取得するためにテキスト フォーマッタが使用するメソッドです。次のいずれかの条件が発生するまで、GetTextRun はテキスト フォーマッタによって繰り返し呼び出されます。

• TextEndOfLine またはサブクラスが返された場合。

• テキスト ランの累積幅が、テキスト フォーマッタを作成する呼び出し、またはテキスト フォーマッタの FormatLine メソッドのいずれかに指定されている行の最大幅を超えた場合。

• "CF"、"LF"、または "CRLF" などの Unicode 改行シーケンスが返された場合。

テキスト ランの提供

テキスト フォーマッタとテキスト ストアの間の対話は、テキスト書式設定プロセスにおける中核となります。TextSource を実装することにより、テキスト フォーマッタに TextRun オブジェクトおよびテキスト ランの書式設定に使用されるプロパティが提供されます。この対話は、テキスト フォーマッタによって呼び出される GetTextRun メソッドによって処理されます。

定義済みの TextRun オブジェクトの一部を次の表に示します。

定義済みの TextRun オブジェクトは、すべてサブクラス化できます。これにより、カスタム データを含むテキスト ランをテキスト ソースからテキスト フォーマッタに提供できます。

GetTextRun メソッドの例を次に示します。このテキスト ストアは、次のテキスト フォーマッタに TextRun オブジェクトを返して処理を行います。

メモ :
この例では、テキスト ストアによりすべてのテキストに対して同じテキスト プロパティが提供されます。高度なテキスト ストアの場合、個々の文字に異なるプロパティを持たせるために、それぞれのテキスト ストア の範囲管理を実装する必要があります。

書式設定プロパティの指定

TextRun オブジェクトは、テキスト ストアによって提供されるプロパティを使用して書式設定されます。このようなプロパティには、TextParagraphProperties と TextRunProperties の 2 つの型があります。TextParagraphProperties は、TextAlignment や FlowDirection などの、段落の包括的なプロパティを処理します。TextRunProperties は、前景ブラシ、Typeface、およびフォント サイズなどの、段落内のそれぞれのテキスト ランで異なるプロパティです。カスタム段落プロパティ型およびカスタム テキスト ラン プロパティ型を実装するには、アプリケーションでそれぞれ TextParagraphProperties および TextRunProperties から派生するクラスを作成する必要があります。

参照

概念

Windows Presentation Foundation の文字体裁

Windows Presentation Foundation のドキュメント