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

Статья
03/13/2024

Ограничивает курсор прямоугольной областью на экране. Если последующее положение курсора (заданное функцией SetCursorPos или мышью) находится за пределами прямоугольника, система автоматически настраивает положение курсора, чтобы курсор держался внутри прямоугольной области.

Синтаксис

BOOL ClipCursor(
  [in, optional] const RECT *lpRect
);

Параметры

[in, optional] lpRect

Тип: const RECT*

Указатель на структуру, содержащую экранные координаты верхнего левого и нижнего правого углов ограничивающего прямоугольника. Если этот параметр имеет значение NULL, курсор можно перемещать в любом месте экрана.

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

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

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

Курсор является общим ресурсом. Если приложение ограничивает курсор, оно должно освободить курсор с помощью ClipCursor , прежде чем отказаться от управления другому приложению.

Процесс вызова должен иметь WINSTA_WRITEATTRIBUTES доступ к оконной станции.

Примеры

Пример см. в разделе Ограничение курсора.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll