Функция LoadCursor загружает заданный ресурс курсора из исполняемого (.EXE) файла, связанного с экземпляром прикладной программы.
| Обратите внимание! на то, что эта функция была заменена функцией LoadImage. |
Синтаксис
HCURSOR LoadCursor( HINSTANCE hInstance, LPCTSTR lpCursorName ); |
Параметры
hInstance
[in] Дескриптор экземпляра модуля, исполняемый файл которого содержит загружаемый курсор.
lpCursorName
[in] Указатель на строку с символом нуля в конце, содержащую имя ресурса загружаемого курсора. Или же, этот параметр может состоять из идентификатора ресурса, в младшем слове и нулей в старшем слове. Может также использоваться макрокоманда MAKEINTRESOURCE, чтобы создать это значение.
Чтобы использовать предопределенный курсор, прикладная программа должна установить параметр hInstance в значение ПУСТО (NULL), а параметр lpCursorName в одно из следующих значений:
|
Значение |
Предназначение |
| IDC_APPSTARTING | Стандартная стрелка и маленькие песочные часы. |
| IDC_ARROW | Стандартная стрелка. |
| IDC_CROSS | Перекрестие. |
| IDC_HAND | Windows 98/Me, Windows 2000/XP: Рука. |
| IDC_HELP | Стрелка и вопросительный знак. |
| IDC_IBEAM | Балочный указатель (в форме двутавровой балки) |
| IDC_ICON | Устаревшее для приложений, помеченных как версия 4.0 или выше. |
| IDC_NO | Перечеркнутый круг. |
| IDC_SIZE | Устаревшее для приложений, помеченных как версия 4.0 или выше. Используется IDC_SIZEALL. |
| IDC_SIZEALL | Четырехконечная стрелка, указывающая север, юг, восток и запад. |
| IDC_SIZENESW | Двухконечная стрелка, указывающая северо-восток и юго-запад. |
| IDC_SIZENS | Двухконечная стрелка, указывающая север и юг. |
| IDC_SIZENWSE | Двухконечная стрелка, указывающая северо-запад и юго-восток. |
| IDC_SIZEWE | Двухконечная стрелка, указывающая запад и восток. |
| IDC_UPARROW | Вертикальная стрелка. |
| IDC_WAIT | Песочные часы. |
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - дескриптор недавно загруженного курсора.
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функция LoadCursor загружает ресурс курсора только тогда, если он не был загружен; иначе, функция извлекает дескриптор существующего ресурса. Эта функция возвращает допустимое значение дескриптора курсора только тогда, если параметр lpCursorName указывает на ресурс курсора. Если lpCursorName - указатель на какой-либо тип ресурса отличающегося от курсора (например, пиктограммы), возвращаемое значение не ПУСТО (NULL), даже притом, что это не допустимый дескриптор курсора.
Функция LoadCursor ищет ресурс курсора наиболее соответствующий курсору текущего устройства отображения. Ресурс курсора может быть цветным или одноцветным точечным рисунком.
Windows 95/98/Me: LoadCursorW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Пример
Пример смотри в статье Создание курсора.
Смотри также
Обзор Курсоры, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor
|
Размещение и совместимость LoadCursor |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 3.1 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Реализуется как версии Unicode и ANSI для Windows NT/2000/XP. А также поддерживается программой Microsoft Layer for Unicode. |
|
Замечания по платформе |
Не имеется |