ホーム › Graphics.DirectWrite › IDWriteTextAnalysisSink
IDWriteTextAnalysisSink
COM公式ドキュメント
このインターフェイスは、指定されたテキスト解析の出力を受け取るために、テキスト アナライザーのクライアントによって実装されます。
解説(Remarks)
テキスト アナライザーは、解析シンクの現在の 状態を一切考慮しません。そのため、ある範囲に対する Set メソッドの呼び出しは、同じ範囲に対して以前に設定された解析結果を上書きします。
メソッド 4
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT SetScriptAnalysis(DWORD textPosition, DWORD textLength, DWRITE_SCRIPT_ANALYSIS* scriptAnalysis)
指定されたテキスト範囲のスクリプト解析結果を報告します。
| textPosition | DWORD | in | 報告を開始する先頭位置。 |
| textLength | DWORD | in | 報告対象範囲の UTF16 単位数。 |
| scriptAnalysis | DWRITE_SCRIPT_ANALYSIS* | in | ライティング システム スクリプトを 0 から始まるインデックスで表した値と、テキストの追加シェーピングが必要かどうかを示す値を格納する構造体へのポインター。 |
戻り値
型: HRESULT
解析を停止するための成功コードまたはエラー コード。
vtbl 4 HRESULT SetLineBreakpoints(DWORD textPosition, DWORD textLength, DWRITE_LINE_BREAKPOINT* lineBreakpoints)
指定された位置から始めて、各文字に対する改行の可否を設定します。
| textPosition | DWORD | in | 報告を開始する先頭テキスト位置。 |
| textLength | DWORD | in | 報告対象範囲の UTF16 単位数。 |
| lineBreakpoints | DWRITE_LINE_BREAKPOINT* | in | 先頭位置から指定された範囲の末尾までの各文字に設定される改行条件を格納する構造体へのポインター。 |
戻り値
型: HRESULT
解析を停止するための成功コードまたはエラー コード。
vtbl 5 HRESULT SetBidiLevel(DWORD textPosition, DWORD textLength, BYTE explicitLevel, BYTE resolvedLevel)
範囲に対して双方向 (bidi) レベルを設定します。これはラン (run) が変化するたびに 1 回ずつ呼び出されます (明示的なランでも、解決された暗黙的なランでも同様)。
| textPosition | DWORD | in | 報告を開始する先頭位置。 |
| textLength | DWORD | in | 報告対象範囲の UTF16 単位数。 |
| explicitLevel | BYTE | in | 段落の読み方向と、埋め込まれた制御コード RLE/RLO/LRE/LRO/PDF から決まる明示的レベル。これは追加の規則を適用する前に決定されます。 |
| resolvedLevel | BYTE | in | すべての Bidi 規則を適用した後に、 明示的レベルと文字本来の方向性を考慮して 決定される最終的な暗黙的レベル。 |
戻り値
型: HRESULT
解析を停止するための成功コードまたはエラー コード。
vtbl 6 HRESULT SetNumberSubstitution(DWORD textPosition, DWORD textLength, IDWriteNumberSubstitution* numberSubstitution)
テキスト解析の対象となるテキスト範囲に数字置換 (number substitution) を設定します。
| textPosition | DWORD | in | 報告を開始する先頭位置。 |
| textLength | DWORD | in | 報告対象範囲の UTF16 単位数。 |
| numberSubstitution | IDWriteNumberSubstitution* | in | 指定されたロケールに適した数字および数値用の約物を保持するオブジェクト。このオブジェクトを作成するには IDWriteFactory::CreateNumberSubstitution を使用します。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IDWriteTextAnalysisSink "{5810CD44-0CA0-4701-B3FA-BEC5182AE4F6}" #usecom global IDWriteTextAnalysisSink IID_IDWriteTextAnalysisSink "{}" #comfunc global IDWriteTextAnalysisSink_SetScriptAnalysis 3 int,int,var #comfunc global IDWriteTextAnalysisSink_SetLineBreakpoints 4 int,int,var #comfunc global IDWriteTextAnalysisSink_SetBidiLevel 5 int,int,int,int #comfunc global IDWriteTextAnalysisSink_SetNumberSubstitution 6 int,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDWriteTextAnalysisSink "{5810CD44-0CA0-4701-B3FA-BEC5182AE4F6}" #usecom global IDWriteTextAnalysisSink IID_IDWriteTextAnalysisSink "{}" #comfunc global IDWriteTextAnalysisSink_SetScriptAnalysis 3 int,int,sptr #comfunc global IDWriteTextAnalysisSink_SetLineBreakpoints 4 int,int,sptr #comfunc global IDWriteTextAnalysisSink_SetBidiLevel 5 int,int,int,int #comfunc global IDWriteTextAnalysisSink_SetNumberSubstitution 6 int,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。