setInputScope 函数 (inputscope.h)
设置指定窗口的输入范围。
语法
HRESULT SetInputScope(
[in] HWND hwnd,
[in] InputScope inputscope
);
parameters
[in] hwnd
要设置作用域的窗口。
[in] inputscope
要与窗口关联的输入范围。 若要删除输入范围关联,请将IS_DEFAULT传递给此参数。
返回值
值 | 含义 |
---|---|
S_OK | 方法成功。 |
注解
调用此方法将替换与窗口关联的任何范围。
应用程序必须调用此方法,并将IS_DEFAULT传递到 hwnd 参数,以在销毁窗口之前删除输入范围关联。
仅当窗口 (hwnd 参数) 且调用线程在同一线程中时,此 API 才有效。 如果为其他线程的窗口调用此 API,它将失败并出现E_INVALIDARG。
如果在尚未与文档管理器关联的窗口 (hwnd 参数) 上调用此方法,则不会向感兴趣的客户端发送文本服务通知 (,例如可能需要响应范围更改的触摸键盘) 。
示例
[C++]
以下代码演示如何设置窗口的输入范围。
SetInputScope(hwnd, IS_EMAIL_USERNAME);
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | inputscope.h |
DLL | Msctf.dll |