IDWriteTextAnalysisSource::GetTextAtPosition メソッド (dwrite.h)

  • [アーティクル]

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

構文

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

パラメーター

textPosition

種類: UINT32

取得するピースの最初の位置。 すべての位置は UTF16 コード単位であり、補助文字を使用する場合に重要な文字全体ではありません。

[out] textString

型: const WCHAR**

このメソッドが戻るとき、 には、テキスト分析から取得する文字の配列としてテキスト ブロックのアドレスが含まれます。

[out] textLength

型: UINT32*

このメソッドが戻るとき、 には、取得したチャンクの UTF16 単位の数が格納されます。 返される長さは、ブロックの長さではなく、指定した位置から最後までのブロック内に残っている長さです。 たとえば、75 桁の位置を 100 位置のブロックに照会すると、25 が返されます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

NULL を返す文字列の末尾を示します。これは、最後の文字の後ろの位置です。 この関数は、連続するブロックごとに繰り返し呼び出され、バッキング ストア内のいくつかのフラグメント化されたブロックを仮想連続した文字列に結び付けます。

アプリケーションでは、バッキング ストアの一部のみをマップするスパース テキスト コンテンツを実装できますが、アプリケーションは、分析関数に渡される範囲内のテキストをマップする必要があります。

要件

   
サポートされている最小のクライアント Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー dwrite.h
Library Dwrite.lib
[DLL] Dwrite.dll

関連項目

IDWriteTextAnalysisSource