Функция CreateIconFromResource создает значок или курсор из битов ресурса, описывающих значок.
Чтобы определить желательную высоту или ширину, используйте функцию CreateIconFromResourceEx.
Синтаксис
HICON CreateIconFromResource( PBYTE presbits, DWORD dwResSize, BOOL fIcon, DWORD dwVer ); |
Параметры
presbits
[in] Указатель на буфер, содержащий в себе биты ресурса значка или курсора. Эти биты обычно загружаются при помощи вызовов функций LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx и LoadResource.
dwResSize
[in] Определяет размер набора битов, указанных при помощи параметра presbits, в байтах.
fIcon
[in] Определяет, что должно быть создано - значок или курсор. Если этот параметр - ИСТИНА (TRUE), создается значок. Если он - ЛОЖЬ (FALSE), создается курсор.
dwVer
[in] Определяет номер версии значка или формат курсора из битов ресурса указанного при помощи параметра presbits. Этот параметр может быть равен 0x00030000.
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение - дескриптор значка или курсора.
Если функция завершается ошибкой, возвращаемое значение - NULL. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Замечания
Функции CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory и LookupIconIdFromDirectoryEx дают возможность оболочке приложения и программам просмотра значка проверять и использовать ресурсы по всей системе.
Функция CreateIconFromResource вызывает функцию CreateIconFromResourceEx, передавая LR_DEFAULTSIZE | LR_SHARED как флажки.
Смотри такжеОбзор Значки, Функции, используемые значками, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx
Размещение и совместимость CreateIconFromResource | ||
К | Windows XP | Да |
л | Windows 2000 Professional | Да |
и | Windows NT Workstation | Да версии 3.1 и выше |
е | Windows Me | Да |
н | Windows 98 | Да |
т | Windows 95 | Да |
С | Windows 2003 Server | Да |
е | Windows 2000 Server | Да |
р | Windows NT Server | Да версии 3.1 и выше |
в | ||
е | ||
р | ||
Используемая библиотека | User32.lib | |
Используемая DLL | user32.dll | |
Заголовочный файл | ||
- объявлено в | Winuser.h | |
- включено в | Windows.h | |
Unicode | ||
Замечания по платформе | Не имеется |