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

  • [アーティクル]

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

構文

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 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー textstor.h
[DLL] Msctf.dll

こちらもご覧ください

ITextStoreACP2