setCaretPos 函数 (winuser.h)
将插入点移动到指定的坐标。 如果拥有插入点的窗口是使用 CS_OWNDC 类样式创建的,则指定的坐标受与该窗口关联的设备上下文的映射模式的约束。
语法
BOOL SetCaretPos(
[in] int X,
[in] int Y
);
参数
[in] X
类型: int
插入点的新 x 坐标。
[in] Y
类型: int
插入点的新 y 坐标。
返回值
类型: BOOL
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
SetCaretPos 移动插入点是否隐藏插入点。
系统为每个队列提供一个插入点。 仅当窗口具有键盘焦点或处于活动状态时,才应创建插入点。 窗口应在失去键盘焦点或变为非活动状态之前销毁插入符号。 仅当窗口拥有插入点时,窗口才能设置插入点位置。
DPI 虚拟化
此 API 不参与 DPI 虚拟化。 根据与插入点关联的窗口,所提供的位置被解释为逻辑坐标。 不考虑调用线程。示例
有关示例,请参阅 创建和显示插入点。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | winuser.h (包括 Windows.h) |
Library | User32.lib |
DLL | User32.dll |
API 集 | 在 Windows 8) 中引入的 ext-ms-win-ntuser-caret-l1-1-0 ( |
另请参阅
概念性
引用