LoadCursor

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

Эта функция была заменена LoadImage функцию

() HCURSOR LoadCursor HINSTANCE  hInstance, / / обработать для экземпляра приложенияLPCTSTRlpCursorName / / имя string или курсор идентификатор ресурса);
 

Параметры

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

Чтобы использовать один из Win32 предопределенных курсоров, приложение должно установить hInstance параметра в NULL, параметр lpCursorName для одной следующие значения:
Значение Описание
IDC_APPSTARTING Стандартная стрелка и малых песочных часов
IDC_ARROW Стандартная стрелка
IDC_CROSS Перекрестие
IDC_HAND Windows NT 5.0 и более поздних: Рука
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 CE: Используйте компонент курсор, когда выбор платформы, которые не поддерживают курсоры мыши. Единственное курсор, который поддерживает этот компонент — курсор ожидания (IDC_WAIT). Использовать функцию LoadCursor в сочетании с функцией SetCursor установить курсор ожидания.

SetCursor (LoadCursor (NULL, IDC_WAIT))

Используйте компонент mcursor, когда выбор платформы, поддерживающий курсоры мыши. Этот компонент поддерживает функцию LoadCursor же образом Windows сделать настольных платформ, за исключением того, что он поддерживает только монохромные курсоров. Windows CE не поддерживает цветовых курсоров. Попытка загрузить цветной курсор будет иметь непредсказуемые результаты.

Родственные слова

Обзор курсоры, функции работы с курсорами, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index