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
);

parameters

[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