平台 SDK: Windows 用户接口

SetCaretPos

SetCaretPos函数将插入符号移动到指定的坐标位置。 如果拥有插入符号的窗口是使用CS_OWNDC类样式创建的,则指定的坐标将受到与该窗口关联的设备上下文的映射模式的约束。

BOOL SetCaretPos(
  int X,  // 水平位置
  int Y   // 垂直位置
);

参数

  • X

  • [in] 指定插入符号的新x坐标。

  • Y

  • [in] 指定插入符号的新y坐标。

返回值

如果函数成功,返回值为非零。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

备注

SetCaretPos移动插入符号,不管插入符号是否被隐藏。

系统为每个队列提供一个插入符号。 一个窗口只有在键盘焦点或活动时才能创建插入符。 在丢失键盘焦点或变为不活动状态之前,窗口应该销毁插入符号。 窗口只有拥有插入符号才能设置插入位置。

示例代码

有关示例,请参阅创建和显示插入符号。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 包含在Windows 95和更高版本中。

  头文件: 声明于 Winuser.h; 包含于 Windows.h.
  库: 使用 User32.lib.