Функция SetCursorPos (winuser.h)

Статья
08/28/2023

Перемещает курсор на указанные экранные координаты. Если новые координаты не находятся в прямоугольнике экрана, заданном последним вызовом функции ClipCursor , система автоматически корректирует координаты таким образом, чтобы курсор оставался внутри прямоугольника.

Синтаксис

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

Параметры

[in] X

Тип: int

Новая координата курсора по оси X в экранных координатах.

[in] Y

Тип: int

Новая координата курсора по оси Y в экранных координатах.

Возвращаемое значение

Тип: BOOL

Возвращает ненулевое значение при успешном выполнении или нулевое значение в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Входной рабочий стол должен быть текущим рабочим столом при вызове SetCursorPos. Вызовите OpenInputDesktop , чтобы определить, является ли текущий рабочий стол рабочим столом ввода. Если это не так, вызовите SetThreadDesktop с HDESK , возвращенным OpenInputDesktop , чтобы переключиться на этот рабочий стол.

Примеры

Пример см. в разделе Использование клавиатуры для перемещения курсора.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-2 (представлено в Windows 10 версии 10.0.10240)