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

ITfFnReconversion::QueryRange メソッドは、再変換が適用されるテキストの範囲を取得します。

構文

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

パラメーター

[in] pRange

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

ppNewRange

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

このメソッドがテキスト サービスによって実装される場合、このパラメーターは省略可能であり、NULL にすることができます。 この場合、範囲は必要ありません。

このメソッドの TSF マネージャーの実装が呼び出されると、このパラメーターは省略可能ではなく、NULL にすることはできません。

[out] pfConvertable

pRange の対象となるテキストを再変換できない場合、またはそれ以外の場合は 0 以外の場合に 0 を受け取る BOOL 値へのポインター。

戻り値

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

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

要件

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

関連項目

ITfFnReconversion

ITfRange