ITextStoreAnchor::GetTextExt メソッド (textstor.h)
ITextStoreAnchor::GetTextExt メソッドは、テキスト範囲の境界ボックスを画面座標で返します。 呼び出し元は、このメソッドを呼び出す前に、ドキュメントの読み取り専用ロックを持っている必要があります。
構文
HRESULT GetTextExt(
[in] TsViewCookie vcView,
[in] IAnchor *paStart,
[in] IAnchor *paEnd,
[out] RECT *prc,
[out] BOOL *pfClipped
);
パラメーター
[in] vcView
コンテキスト ビューを指定します。
[in] paStart
範囲の先頭に配置されるアンカーを指定します。
[in] paEnd
範囲の末尾に配置されるアンカーを指定します。
[out] prc
テキスト範囲の境界ボックスを画面座標で受け取ります。
[out] pfClipped
境界ボックス内のテキストがクリップされたかどうかを指定するブール値を受け取ります。 TRUE の場合、境界ボックスにはクリップされたテキストが含まれており、要求されたテキスト範囲全体は含まれません。 要求された範囲が表示されないため、境界ボックスはクリップされます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
|
メソッドは、開始アンカーまたは終了アンカーへの有効なインターフェイス ポインターを取得できませんでした。 |
|
1 つ以上の入力パラメーターが無効です。 |
|
paStart パラメーターと paEnd パラメーターで指定された範囲は、文書の先頭または末尾を超えています。 |
|
アプリケーションでテキスト レイアウトが計算されていません。 それ以降の呼び出しは、アプリケーションが ITextStoreAnchorSink::OnLayoutChange を呼び出すまで成功しません。 |
|
呼び出し元は、ドキュメントに対する読み取り専用ロックを持っていません。 |
注釈
ドキュメント ウィンドウが最小化されている場合、または指定したテキストが現在表示されていない場合、メソッドは prc パラメーターを に設定してS_OKを {0,0,0,0}返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | textstor.h |
[DLL] | Msctf.dll |
再頒布可能パッケージ | Windows 2000 Professional 上の TSF 1.0 |