Функция 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 |
Нет |
Замечания по платформе |
Не имеется |