Win32 API. Курсоры
Страница 22. Функция LoadCursorFromFile


Функция LoadCursorFromFile

(ЗагрузитьКурсорИзФайла)

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

Синтаксис

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

);

Параметры
lpFileName
Указывает источник данных файла, которые нужно использовать, чтобы создать курсор. Данные в файле должны быть или в формате .ANI или .CUR.
Если старшее слово LoadCursorFromFile отлично от нуля, это - указатель на строку, которая является полностью составным именем файла, содержащего данные курсора.
Если старшее слово lpszFileName нулевое, младшее слово является идентификатором курсора системы. Затем функция ищет входную точку [Cursors] в файле WIN.INI для файла, связанного с именем этого курсора системы. Имеется список имен курсоров системы и идентификаторов:

Имена Системных КурсоровИдентификаторы Системных Курсоров
"Arrow" -стрелкаOCR_NORMAL
"IBeam" - I - образная линия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

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

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
UnicodeWinNT
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »