LoadCursorFromFile

Функция LoadCursorFromFile создает курсор, основанный на данных, содержащихся в файле. Файл задается его именем или идентификатором системного курсора. Функция возвращает дескриптор созданного курсора. Файлы, содержащие данные, могут быть либо файлами курсоров (. CUR ), либо файлами анимированных курсоров (. ANI ).

HCURSOR LoadCursorFromFile (

LPCTSTR lpFileName // указатель на имя файла с курсором или

// идентификатор системного курсора

);

Параметры

lpFileName - указывает на источник файловых данных, используемых для создания курсора. Файлы, должны быть либо файлами курсоров (. CUR ), либо файлами анимированных курсоров (. ANI ).

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

Если старшее слово lpFileName равно нулю, нижнее слово представляет собой идентификатор системного курсора. Затем функция просматривает секцию [ Cursors ] в файле WIN . INI на предмет файла, связанного с именем указанного системного курсора. Ниже приводится список имен системных курсоров и идентификаторов:

Имена системных курсоров

Идентификаторы системных курсоров

"Arrow"

OCR_NORMAL

"IBeam"

OCR_IBEAM

"Wait"

OCR_WAIT

"Crosshair"

OCR_CROSS

"UpArrow"

OCR_UP

"Size"

OCR_SIZE

"Icon"

OCR_ICON

"SizeNWSE"

OCR_SIZENWSE

"SizeNESW"

OCR_SIZENESW

"SizeWE"

OCR_SIZEWE

"SizeNS"

OCR_SIZENS

"SizeAll"

OCR_SIZEALL

"No"

OCR_NO

"AppStarting"

OCR_APPSTARTING

Например, если в WIN . INI содержится следующее:

[Cursors]

Arrow = "arrow.ani"

то вызов LoadCursorFromFile (( LPWSTR ) OCR _ NORMAL ) заставит функцию LoadCursorFromFile получить данные из файла ARROW . ANI . Если WIN . INI не содержит строки для указанного системного курсора, вызов функции завершится неудачей и функция вернет NULL .

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

В случае успеха возвращается дескриптор нового курсора.

В случае неудачи возвращается NULL . Для получения дополнительной информации об ошибке вызовите функцию GetLastError . GetLastError может вернуть следующее значение: ERROR _ FILE _ NOT _ FOUND - указанный файл не может быть найден.

См. также

LoadCursor, SetCursor, SetSystemCursor .