Поделиться через


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

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

См. также раздел

Основные понятия

Курсоры

GetClipCursor

GetCursorPos

Другие ресурсы

RECT

Справочные материалы

SetCursorPos