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