User and Graphics Device Interface Objects, страница 4

Смотри также

CreateCursor

LoadCursor

Функция LoadCursor загружает определенный ресурс курсора из исполняемого (.EXE) файла, ассоциированного с экземпляром приложения.

HCURSOR LoadCursor(

    HINSTANCE  hInstance,      // описатель экземпляра приложения

    LPCTSTR  lpCursorName    // имя строки или идентификатора ресурса курсора

   );          

Параметры

hInstance

Идентифицирует экземпляр модуля, чей исполняемый файл содержит курсор для загрузки.

lpCursorName

Указывает на оканчивающуюся null строку, которая содержит имя ресурса курсора, который должен загружаться. Кроме того, этот параметр может состоять из идентификатора ресурса в младшем слове и нуле в старшем слове. MAKEINTRESOURCE макрос может также использоваться, чтобы создать эту величину.

Чтобы использовать один из встроенных курсоров Win32, приложение должно установить параметр hInstance в NULL и lpCursorName в одно из следующих значений:

Value                               Description

IDC_APPSTARTING  Стандартный указатель и песочные часы

IDC_ARROW              Стандартный указатель

IDC_CROSS                Перекрестие (форма курсора)

IDC_IBEAM                Текстовый I-курсор

IDC_ICON                  Windows NT только: Пустой образ

IDC_NO                      Урезанный круг

IDC_SIZE                    Windows NT только: Четырех сторонняя стрелка

IDC_SIZEALL             Тоже что IDC_SIZE

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

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

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

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

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

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

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

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

Замечание

LoadCursor только загружает ресурс курсора если он не был загружен; в противном случае, он извлекает описатель существующего ресурса. Эта функция возвращает правильную описатель курсора, только если lpCursorName параметр указывает на ресурс курсора. Если lpCursorName указывает не на курсор, а на любой другой тип ресурса, возвращаемое значение будет NULL, даже если это недействительный описатель курсора.

Функция LoadCursor ищет ресурс курсора наиболее подходящий для курсора для текущего дисплейного устройства. Ресурс курсора может быть цветным или монохромным побитовым отображением.

Смотри также

LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

GetCursor

Функция GetCursor извлекает описатель текущего курсора.

HCURSOR GetCursor(VOID)

Параметры

Эта функция не имеет параметров.

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

В случае успешного завершения, возвращаемое значение описатель текущего курсора. В случае неудачи, возвращаемое значение NULL.

Смотри также

SetCursor

SetCursor

Функция SetCursor устанавливает форму курсора.

HCURSOR SetCursor(

    HCURSOR  hcur        // описатель курсора

   );          

Параметры

hcur

Идентифицирует курсор. Курсор должен быть создан функцией CreateCursor или загружен одной из следующих функций:

Windows 95: функция LoadCursor  или LoadImage

Windows NT: LoadCursor

Если этот параметр равен NULL, курсор удаляется с экрана.

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

Возвращаемое значение - описатель курсора, если курсор существовал. Если не было ни одного предшествующего курсора, величина возврата NULL.

Замечания

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