SetInputScopes 関数 (inputscope.h)

指定されたウィンドウに対して、1 つの入力スコープ、複数の入力スコープ、1 つのフレーズ リスト、正規表現、音声認識文法仕様 (SRGS) ルールの組み合わせを設定します。

構文

HRESULT SetInputScopes(
  [in] HWND             hwnd,
  [in] const InputScope *pInputScopes,
  [in] UINT             cInputScopes,
  [in] PWSTR            *ppszPhraseList,
  [in] UINT             cPhrases,
  [in] PWSTR            pszRegExp,
  [in] PWSTR            pszSRGS
);

パラメーター

[in] hwnd

スコープを設定するウィンドウ。

[in] pInputScopes

入力スコープの配列へのポインター。 NULL を指定できます。 NULL でない場合、配列内のすべての入力スコープは、同じ重みを持つウィンドウの入力スコープとして設定されます。 IS_DEFAULTを使用して、他のすべての入力スコープも受け入れます。

[in] cInputScopes

*pInputScopes が指す配列内の入力スコープの数。 配列が NULL の場合、この値は 0 である必要があります。

[in] ppszPhraseList

NULL で終わる語句へのポインターの配列へのポインター。 NULL を指定できます。

[in] cPhrases

**ppszPhraseList によって指されるポインターの数。これは、語句の数を表します。

[in] pszRegExp

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

[in] pszSRGS

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

戻り値

値	説明
S_OK	メソッドは正常に実行されました。

解説

このメソッドを呼び出すと、ウィンドウに関連付けられているスコープが置き換えられます。

この API は、ウィンドウ (hwnd パラメーター) と呼び出し元のスレッドが同じスレッドにある場合にのみ機能します。 別のスレッドのウィンドウに対してこの API を呼び出すと、E_INVALIDARGで失敗します。

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

要件

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