ITextStoreACP::GetTextExt メソッド (textstor.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] vcView

コンテキスト ビューを指定します。

[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
ヘッダー textstor.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional 上の TSF 1.0

こちらもご覧ください

ITextStoreACP

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt