ITfFnLMProcessor::QueryRange メソッド (ctffunc.h)

  • [アーティクル]

再変換が適用されるテキストの範囲を取得します。

構文

HRESULT QueryRange(
  [in]  ITfRange *pRange,
  [out] ITfRange **ppNewRange,
  [out] BOOL     *pfAccepted
);

パラメーター

[in] pRange

再変換するテキストのすべてまたは一部をカバーする ITfRange オブジェクトへのポインター。

[out] ppNewRange

再変換できるすべてのテキストをカバーする範囲オブジェクトを受け取る ITfRange ポインターへのポインター。 pRange の対象となるテキストを再変換できない場合、このパラメーターは NULL を受け取ります。 この場合、 メソッドは S_OKを返します。呼び出し元は、ポインターを使用する前に、このパラメーターが NULL ではないことを確認する必要があります。

このパラメーターは省略可能であり、 NULL にすることができます。 この場合、範囲は必要ありません。

[out] pfAccepted

pRange でカバーされるテキストを再変換できない場合は 0 を受け取る BOOL 値へのポインター。それ以外の場合は 0 以外の値を返します。

戻り値

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

値 説明
S_OK
 メソッドは正常に実行されました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY
 メモリ割り当てエラーが発生しました。

注釈

このメソッドは、 ITfFnReconversion::QueryRange と同じです。 テキスト サービスで ITfFnReconversion::QueryRange が呼び出されると、言語モデル プロセッサがインストールされている場合、テキスト サービスは呼び出しをこのメソッドに転送する必要があります。 言語モデル プロセッサがインストールされていない場合、テキスト サービスは既定の処理を実行する必要があります。

要件

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

こちらもご覧ください

ITfFnLMProcessor

ITfFnReconversion::QueryRange

ITfRange