Функция SetSystemCursor

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

Синтаксис

BOOL SetSystemCursor(
    HCURSOR hcur,
    DWORD id
);

Параметры

hcur

[in] Дескриптор курсора. Функция заменяет содержимое системного курсора, заданного параметром id, содержимым курсора, обработанного при помощи hcur

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

id  

[in] Определяет системный курсор, который заменяется содержанием hcur. Этим параметром может быть одно из ниже перечисленных значений.

Значение

Предназначение

OCR_APPSTARTING

Стандартная стрелка и маленькие песочные часы

OCR_NORMAL

Стандартная стрелка

OCR_CROSS Перекрестие
OCR_HAND Windows 2000/XP: Рука

OCR_HELP

Стрелка и знак вопроса

OCR_IBEAM

Балочный (в форме двутавровой балки)

OCR_NO

Перечеркнутый круг

OCR_SIZEALL Четырехконечная стрелка, указывающая север, юг, восток и запад
OCR_SIZENESW Двухконечная стрелка, указывающая северо-восток и юго-запад

OCR_SIZENS

Двухконечная стрелка, указывающая север и юг

OCR_SIZENWSE Двухконечная стрелка, указывающая северо-запад и юго-восток

OCR_SIZEWE

Двухконечная стрелка, указывающая запад и восток

OCR_UP

Вертикальная стрелка

OCR_WAIT

Песочные часы
 

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

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

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

Смотри также

Обзор КурсорыDestroyCursor, LoadCursor, LoadCursorFromFile, SetCursor

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

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

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

User32.lib

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

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz