IDWriteTextLayout_HitTestTextRange

アプリケーションはこの関数を呼び出して、テキスト位置の範囲に対応するヒットテストメトリックのセットを取得する。主な用途の一つはテキスト文字列のハイライト選択の実装である。

IDWriteTextLayout_HitTestTextRange this, textPosition, textLength, originX, originY, hitTestMetrics, maxHitTestMetricsCount, actualHitTestMetricsCount

this : [comobj] IDWriteTextLayout インターフェースの COM オブジェクト変数
textPosition : [int] 型: UINT32 指定範囲の最初のテキスト位置。
textLength : [int] 型: UINT32 指定範囲の位置数。
originX : [float] 型: FLOAT レイアウトボックスの左端にある原点ピクセル位置 X。このオフセットは返されるヒットテストメトリックに加算される。
originY : [float] 型: FLOAT レイアウトボックスの上端にある原点ピクセル位置 Y。このオフセットは返されるヒットテストメトリックに加算される。
hitTestMetrics : [var] 型: DWRITE_HIT_TEST_METRICS* このメソッドが返るとき、指定した位置範囲を完全に囲む出力ジオメトリのバッファへのポインタが格納される。このバッファは少なくとも maxHitTestMetricsCount 以上の大きさが必要である。
maxHitTestMetricsCount : [int] 型: UINT32 hitTestMetrics のバッファメモリに保持できるボックスの最大個数。
actualHitTestMetricsCount : [int] 型: UINT32* hitTestMetrics のバッファメモリに保持されるジオメトリの実際の個数。

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

解説

アプリケーションはこの関数を呼び出して、テキスト位置の範囲に対応するヒットテストメトリックのセットを取得する。主な用途の一つはテキスト文字列のハイライト選択の実装である。

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

情報