IDWriteTextAnalysisSource_GetTextAtPosition

指定したテキスト位置から始まるテキストブロックを取得する。

IDWriteTextAnalysisSource_GetTextAtPosition this, textPosition, textString, textLength

this : [comobj] IDWriteTextAnalysisSource インターフェースの COM オブジェクト変数
textPosition : [int] 型: UINT32 取得する部分の先頭位置。位置はすべて UTF16 コード単位であり、文字単位ではないため、補助文字が使用されている場合に影響する。
textString : [var] 型: const WCHAR** このメソッドが返るとき、テキスト分析から取得されるテキストブロックを表す文字配列のアドレスを格納する。
textLength : [int] 型: UINT32* このメソッドが返るとき、取得したチャンクの UTF16 単位数を格納する。返される長さはブロックの長さではなく、指定位置からブロック末尾までの残りの長さである。たとえば 100 単位のブロック内の 75 単位目の位置を問い合わせた場合は 25 を返す。

(プラグイン / モジュール : com_misc.dll)

解説

指定したテキスト位置から始まるテキストブロックを取得する。

[戻り値]
型: HRESULT このメソッドが成功した場合は S_OK を返す。失敗した場合は HRESULT エラーコードを返す。

[備考]
NULL を返すとテキストの終端 (最終文字の次の位置)
を示す。この関数は連続する各ブロックに対して繰り返し呼び出され、バッキングストア上の複数の断片化したブロックを仮想的な連続文字列として結びつける。アプリケーションはバッキングストアの一部のみをマップする疎なテキストコンテンツを実装できるが、分析関数に渡された範囲内のテキストは必ずマップしなければならない。

情報