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