Поделиться через


Функция LoadCursorFromFileA (winuser.h)

Создает курсор на основе данных, содержащихся в файле.

Заметка

Эта функция заменена функцией LoadImage (с набором флагов LR_DEFAULTSIZE и LR_LOADFROMFILE).

Синтаксис

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Параметры

[in] lpFileName

Тип: LPCTSTR

Источник данных файла, используемый для создания курсора. Данные в файле должны находиться в любом из этих файлов. CUR или . Формат ANI.

Если слово с высоким порядком lpFileName ненулевое, это указатель на строку, которая является полным именем файла, содержащего данные курсора.

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

Тип: HCURSOR

Если функция выполнена успешно, возвращаемое значение является дескриптором нового курсора.

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

Возвращаемый код Описание
ERROR_FILE_NOT_FOUND
Не удается найти указанный файл.

Замечания

виртуализация DPI

Этот API не участвует в виртуализации DPI. Возвращаемые выходные данные не влияют на DPI вызывающего потока.

Заметка

Заголовок winuser.h определяет LoadCursorFromFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка winuser.h (включая Windows.h)
библиотеки User32.lib
DLL User32.dll

См. также

концептуальные

курсоров

LoadCursor

Справочник

SetCursor

SetSystemCursor