Страница 22 из 28
Функция 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 Замечания по платформеНе имеется |