ITfContextOwner::GetTextExt メソッド (msctf.h)

ITfContextOwner::GetTextExt メソッドは、指定した文字位置にあるテキストの境界ボックスを画面座標で返します。呼び出し元は、このメソッドを呼び出す前に、ドキュメントの読み取り専用ロックを持っている必要があります。

構文

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

[in] acpStart

文書内で取得するテキストの開始文字位置を指定します。

[in] acpEnd

文書内で取得するテキストの終了文字位置を指定します。

[out] prc

指定した文字位置にあるテキストの境界ボックスを画面座標で受け取ります。

[out] pfClipped

境界ボックス内のテキストがクリップされているかどうかを指定するブール値を受け取ります。このパラメーターが TRUE の場合、境界ボックスにはクリップされたテキストが含まれており、要求されたテキスト範囲全体は含まれません。要求された範囲が表示されないため、境界ボックスがクリップされます。

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
TS_E_INVALIDARG	指定した開始文字と終了文字の位置が等しくなります。
TS_E_INVALIDPOS	acpStart パラメーターと acpEnd パラメーターで指定された範囲は、文書の末尾または文書の先頭を越えて拡張されます。
TS_E_NOLAYOUT	アプリケーションでテキストレイアウトが計算されていません。
TS_E_NOLOCK	呼び出し元は、ドキュメントに対する読み取り専用ロックを持っていません。

ドキュメントウィンドウが最小化されている場合、または指定したテキストが現在表示されていない場合、メソッドは prc パラメーターをに設定してS_OKを {0,0,0,0}返します。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msimtf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0