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