Функция 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 , чтобы определить, является ли текущий рабочий стол рабочим столом ввода. Если это не так, вызовите 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) |
См. также раздел
Основные понятия
Справочные материалы