5.11.1.1 - Функция ClipCursor

(ОграничениеКурсора)

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

Синтаксис

BOOL ClipCursor
(
	CONST RECT *lpRect 	// указатель на структуру прямоугольника
);

Параметры
lpRect
Указывает на структуру RECT, которая содержит экранные координаты левого верхнего и нижнего правого углов прямоугольника ограничения. Если этот параметр значение ПУСТО (NULL), курсор свободен для передвижения в любое место экрана.

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

Замечания
Курсор - общедоступный ресурс. Если прикладная программа ограничивает курсор, она должна освободить курсор, используя ClipCursor перед отказом от управления им в другой прикладной программе.
Вызываемый процесс должен иметь доступ WINSTA_WRITEATTRIBUTES к месту окна.

Смотри также
GetClipCursor, GetCursorPos, RECT, SetCursorPos

Размещение и совместимость ClipCursor

Windows NT			Да 
Win95				Да 
Win32s				Да 
Импортируемая библиотека		user32.lib 
Заголовочный файл			winuser.h 
Unicode				Нет 
Замечания по платформе		Не имеется

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Владимир Соковиков - 25.04.2002