SetInputScopes2 関数 (inputscope.h)

アプリケーションは、インターフェイスの参照をクリアするためにウィンドウが破棄される前に、IS_DEFAULTを使用して SetInputScope を呼び出す必要があります。

構文

HRESULT SetInputScopes2(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] IEnumString      *pEnumString,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

パラメーター

[in] hwnd

スコープを設定するウィンドウ。 この呼び出しは、前に hwnd に含まれる可能性のあるスコープを置き換えます。

[in] pInputScopes

入力スコープの配列へのポインター。 NULL を指定できます。 NULL でない場合、内に含まれるすべてのスコープは、同じ重みを持つ hwnd の入力スコープとして設定されます。 IS_DEFAULTを使用して、他のすべての入力も受け入れます (これは "強制しない" オプションです)。

[in] cInputScopes

pInputScopes 内の入力スコープの数。 rgScopes が NULL の場合は 0、 pInputScopes が NULL 以外の場合は 0 以外である必要があります。

[in] pEnumString

フレーズ リストの IenumString インターフェイス ポインター。

[in] pszRegExp

認識される正規表現を記述する NULL で終わる文字列へのポインター。 NULL を指定できます。

[in] pszSRGS

音声認識に役立つ音声固有のヒントとルールを提供する NULL で終わる XML 文字列へのポインター。 XML 形式は、 で概説されている音声認識文法仕様 (SRGS) 標準に http://www.w3.org/TR/speech-grammar準拠しています。 NULL を指定できます。 $

戻り値

値	説明
S_OK	入力スコープが正常に設定またはクリアされました。

解説

アプリケーションは、インターフェイスの参照をクリアするためにウィンドウが破棄される前に、IS_DEFAULTを使用して SetInputScope を呼び出す必要があります。

ドキュメント マネージャーに関連付けられていないウィンドウ (hwnd パラメーター) でこのメソッドを呼び出した場合、スコープの変更に対応する必要がある対象のクライアント (タッチ キーボードなど) にテキスト サービス通知は送信されません。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	inputscope.h
[DLL]	Msctf.dll