SetInputScopes 函式 (inputscope.h)

設定一個輸入範圍、多個輸入範圍、一個片語清單、正則運算式和/或語音辨識文法規格的組合， (指定視窗的 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，這個值必須是零。

[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	此方法成功。

備註

呼叫這個方法會取代與視窗相關聯的任何範圍。

只有當視窗 (hwnd 參數) 且呼叫執行緒位於相同的執行緒時，此 API 才有效。 如果您針對不同執行緒的視窗呼叫此 API，它會因為E_INVALIDARG而失敗。

如果您在尚未與檔管理員相關聯的視窗 (hwnd) 參數上呼叫此方法，則不會將任何文字服務通知傳送給感興趣的用戶端 (，例如可能想要回應範圍變更的觸控式鍵盤) 。

需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	inputscope.h
Dll	Msctf.dll