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,則必須為零,如果 pInputScopes 為非Null,則必須為非零。
[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 |