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 (

另请参阅

插入符号

概念性

GetCaretPos

HideCaret

引用

ShowCaret