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

Задает фигуру курсора.

Синтаксис

HCURSOR SetCursor(
  [in, optional] HCURSOR hCursor
);

Параметры

[in, optional] hCursor

Тип: HCURSOR

Дескриптор курсора.

Курсор должен быть создан функцией CreateCursor или CreateIconIndirect либо загружен функцией LoadCursor или LoadImage .

Если этот параметр имеет значение NULL, курсор удаляется с экрана.

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

Тип: HCURSOR

Возвращаемое значение — это дескриптор предыдущего курсора, если он был.

Если предыдущего курсора не было, возвращаемое значение равно NULL.

Комментарии

Курсор устанавливается только в том случае, если новый курсор отличается от предыдущего; В противном случае функция возвращает немедленно.

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

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

Курсор не отображается на экране, если количество отображаемых внутренних курсоров меньше нуля. Это происходит, если приложение использует функцию ShowCursor для скрытия курсора больше раз, чем для отображения курсора.

Примеры

Пример см. в разделе Отображение курсора.

Требования

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

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

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

Курсоры

Создание курсора

CreateCursor

CreateIconIndirect

GetCursor

GetSystemMetrics

LoadCursor

LoadImage

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

SetCursorPos

ShowCursor