SetCursorPos 函数 (winuser.h)

将光标移动到指定的屏幕坐标。 如果新坐标不在由最新 ClipCursor 函数调用设置的屏幕矩形内,则系统会自动调整坐标,使光标停留在矩形内。

语法

BOOL SetCursorPos(
  [in] int X,
  [in] int Y
);

参数

[in] X

类型: int

光标的新 x 坐标(以屏幕坐标为单位)。

[in] Y

类型: int

光标的新 y 坐标(以屏幕坐标表示)。

返回值

类型: BOOL

如果成功,则返回非零值,否则返回零。 要获得更多的错误信息,请调用 GetLastError。

注解

游标是共享资源。 仅当光标位于窗口的工作区时,窗口才应移动光标。

调用进程必须具有对窗口工作站 WINSTA_WRITEATTRIBUTES 访问权限。

调用 SetCursorPos 时,输入桌面必须是当前桌面。 调用 OpenInputDesktop 以确定当前桌面是否为输入桌面。 如果不是,请使用 OpenInputDesktop 返回的 HDESK 调用 SetThreadDesktop 以切换到该桌面。

示例

有关示例,请参阅 使用键盘移动光标

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.10 (240 中引入的 ext-ms-win-ntuser-window-l1-1-2)

另请参阅

ClipCursor

概念性

光标

GetCursorPos

引用

SetCaretPos

SetCursor

ShowCursor