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

Статья
05/20/2023

Позволяет приложению настраивать системные курсоры. Он заменяет содержимое системного курсора, указанного параметром id , содержимым курсора, заданного параметром hcur , а затем уничтожает hcur.

Синтаксис

BOOL SetSystemCursor(
  [in] HCURSOR hcur,
  [in] DWORD   id
);

Параметры

[in] hcur

Тип: HCURSOR

Дескриптор курсора. Функция заменяет содержимое системного курсора, указанного идентификатором , на содержимое курсора, обработанного hcur.

Система уничтожает hcur путем вызова функции DestroyCursor . Поэтому hcur не может быть курсором, загруженным с помощью функции LoadCursor . Чтобы указать курсор, загруженный из ресурса, скопируйте его с помощью функции CopyCursor , а затем передайте его в SetSystemCursor.

[in] id

Тип: DWORD

Системный курсор для замены на содержимое hcur. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
OCR_NORMAL `32512`	Обычный выбор
OCR_IBEAM `32513`	Выделение текста
OCR_WAIT `32514`	Занято
OCR_CROSS `32515`	Выбор точности
OCR_UP `32516`	Альтернативный выбор
OCR_SIZENWSE `32642`	Размер по диагонали 1
OCR_SIZENESW `32643`	Размер по диагонали 2
OCR_SIZEWE `32644`	Горизонтальное изменение размера
OCR_SIZENS `32645`	Вертикальное изменение размера
OCR_SIZEALL `32646`	Move
OCR_NO `32648`	Недоступно
OCR_HAND `32649`	Выбор ссылки
OCR_APPSTARTING `32650`	Работа в фоновом режиме

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

Тип: BOOL

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

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

Требования

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