LoadCursor
Функция LoadCursor загружает указанный ресурс курсора из исполняемого (. EXE ) файла, связанного с экземпляром приложения.
HCURSOR LoadCursor (
HINSTANCE
hInstance
, // дескриптор
экземпляра
приложения
LPCTSTR
lpCursorName // строка с именем курсора
или
// идентификатор ресурса
);
Параметры
hInstance
- идентифицирует экземпляр модуля, чей исполняемый файл
содержит курсор.
lpCursorName
- указывает на завершающуюся нулем строку, которая сдержит
имя ресурса загружаемого курсора. В качестве альтернативы, значение этого параметра
может содержать идентификатор ресурса в младшем слове и нуль в старшем. Используйте
макрос MAKEINTRESOURCE
для создания данного значения.
Для использования предопределенных курсоров Windows установите значение параметра hInstance в NULL , а значение параметра lpCursorName в одно из следующих значений:
|
Значение |
Описание |
|
IDC_ARROW |
Обычный курсор-стрелка. |
|
IDC_IBEAM |
Курсор в виде буквы " I ". |
|
IDC_WAIT |
Курсор "большие песочные часы". |
|
IDC_CROSS |
Курсор-перекрестие. |
|
IDC_UPARROW |
Курсор "стрелка вверх". |
|
IDC_SIZE |
Только Windows NT : четырехконечная стрелка |
|
IDC _ ICON |
Только Windows NT : пустая иконка. |
|
IDC_SIZENWSE |
Курсор изменения размера. Ориентирован с северо-запада на юго-восток. |
|
IDC_SIZENESW |
Курсор изменения размера. Ориентирован с северо-востока на юго-запад. |
|
IDC_SIZEWE |
Горизонтальный курсор изменения размера. |
|
IDC_SIZENS |
Вертикальный курсор изменения размера. |
|
IDC_SIZEALL |
Курсор изменения всех размеров. То же, что и IDC _ SIZE . |
|
IDC _ NO |
Перечеркнутый наискосок круг. |
|
IDC _ APPSTARTING |
Курсор "маленькие песочные часы со стрелкой". |
В случае
успеха возвращается дескриптор загруженного курсора.
В случае неудачи возвращается NULL
. Для дополнительной информации об ошибке вызовите функцию
GetLastError .
Комментарии
LoadCursor
загружает ресурс курсора только в том случае,
если он еще не загружен. В противном случае функция извлекает дескриптор существующего
ресурса. Функция возвращает действительный дескриптор курсора, только если значение
параметра lpCursorName
указывает на ресурс курсора. Если оно указывает на любой другой тип ресурса, отличный
от курсора (например, на иконку), возвращается не
NULL , хотя возвращаемое значение и не будет
действительным дескриптором курсора.
LoadCursor просматривает ресурс на предмет
курсора, наиболее подходящего для текущего устройства изображения. Ресурс курсора
может быть цветным или монохромным битовым образом.
См. также
LoadImage , MAKEINTRESOURCE , SetCursor , SetCursorPos , ShowCursor .