Функция 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" |
Тогда следующий вызов
((LPWSTR) OCR_NORMAL),LoadCursorFromFile |
заставляет функцию
LoadCursorFromFile получить данные курсора из файла ARROW.ANI.Если файл WIN.INI не содержит записи для заданного системного курсора, функция завершается ошибкой и возвращает значение ПУСТО (NULL).
Windows 95/98/Me: LoadCursorFromFileW поддерживается программой Microsoft Layer for Unicode (MSLU). Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Смотри также
Обзор Курсоры, LoadCursor, SetCursor, SetSystemCursor
Размещение и совместимость 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. |
Замечания по платформе |
Не имеется |