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

  • [アーティクル]

オーディオ データを含む単語または語句のテキスト範囲を取得します。

構文

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

パラメーター

[in] pRange

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

[out] ppNewRange

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

[out] pfPlayable

pRange の対象となるテキストにオーディオ データがない場合、またはそれ以外の場合は 0 以外の場合に 0 を受け取る BOOL へのポインター。

戻り値

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

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

解説

このメソッドの現在の実装は簡単です。 pRange を複製し、そのクローンを ppNewRange に配置し、pfPlayable を TRUE に設定して、S_OKを返します。

要件

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

関連項目

ITfFnPlayBack

ITfRange