Функция ClipCursor


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

Синтаксис

BOOL ClipCursor(      
    const RECT* lpRect
);

Параметры

lpRect

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

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

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

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

Замечания

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

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

Пример

Пример смотри в статье Ограничение курсора.

Смотри также

Обзор Курсоры GetClipCursorGetCursorPosRECT SetCursorPos

 

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz