Функция LoadCursorFromFile


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

Синтаксис

HCURSOR LoadCursorFromFile(
    LPCTSTR lpFileName
);

Параметры

lpFileName

[in] Указывает источник данных файла, который нужно использовать, чтобы создать курсор. Данные в файле должны быть в формате или .ANI, или .CUR.

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

Если старшее слово параметра lpszFileName равно нулю, младшее слово является идентификатором системного курсора. Затем функция ищет раздел [Cursors] в файле WIN.INI для файла, связанного с именем этого системного курсора. Список идентификаторов курсоров смотри в разделе Замечания

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

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

Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL). Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError. GetLastError может возвратить нижеследующее значение:

Значение Предназначение
ERROR_FILE_NOT_FOUND Указанный файл не может быть найден.

Замечания

Ниже следует список имен системного курсора и идентификаторов.

Имя курсора

Идентификатор курсора

"AppStarting" OCR_APPSTARTING

"Arrow" -стрелка

OCR_NORMAL

"Crosshair" -крест OCR_CROSS
"Hand" - рука

Windows 2000/XP: OCR_HAND

"Help" OCR_HELP

"IBeam" - I - балочная линия

OCR_IBEAM

"Icon" - пиктограмма

OCR_ICON

"No"

OCR_NO

"Size" -двухконечная стрелка

OCR_SIZE

"SizeAll" -четырехконечная стрелка

OCR_SIZEALL

"SizeNESW" - двухконечная стрелка северо-восток - юго-запад

OCR_SIZENESW

"SizeNS" - двухконечная стрелка север-юг

OCR_SIZENS

"SizeNWSE" - двухконечная стрелка северо-запад - юго-восток

OCR_SIZENWSE

"SizeWE" - двухконечная стрелка запад-восток

OCR_SIZEWE

"UpArrow" -стрелка вверх

OCR_UP

"Wait" - ждать (песочные часы)

OCR_WAIT

Например, если файл WIN.INI содержит следующую запись

[Cursors] 

    Arrow = "arrow.ani" 

Тогда следующий вызов

LoadCursorFromFile((LPWSTR) OCR_NORMAL),

заставляет функцию LoadCursorFromFile получить данные курсора из файла ARROW.ANI

Если файл WIN.INI не содержит записи для заданного системного курсора, функция завершается ошибкой и возвращает значение ПУСТО (NULL).

Windows 95/98/Me: LoadCursorFromFileW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.

Смотри также

Обзор КурсорыLoadCursorSetCursorSetSystemCursor

Размещение и совместимость  LoadCursorFromFile

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.5 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

User32.lib

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Реализуется как версии Unicode и  ANSI для Windows NT/2000/XP. А также поддерживается программой Microsoft Layer for Unicode.

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz