Поделиться через


Функция CreateIconFromResource (winuser.h)

Создает значок или курсор из битов ресурса, описывающих значок.

Чтобы указать нужную высоту или ширину, используйте функцию CreateIconFromResourceEx .

Синтаксис

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

Параметры

[in] presbits

Тип: PBYTE

Указатель буфера, выровненный по DWORD, содержащий биты ресурсов значка или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx и LoadResource .

Дополнительные сведения о значках и формате ресурсов курсора см. в разделе Ресурсы курсора и значка.

[in] dwResSize

Тип: DWORD

Размер (в байтах) набора битов, на который указывает параметр presbits .

[in] fIcon

Тип: BOOL

Указывает, нужно ли создать значок или курсор. Если этот параметр имеет значение TRUE, необходимо создать значок. Если имеет значение FALSE, необходимо создать курсор.

Структура LOCALHEADER определяет хот-спот курсора и является первым считывателем данных из битов ресурса курсора.

[in] dwVer

Тип: DWORD

Номер версии значка или формата курсора для битов ресурса, на которые указывает параметр presbits . Значение должно быть больше или равно 0x00020000 и меньше или равно 0x00030000. Этот параметр обычно имеет значение 0x00030000.

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

Тип: HICON

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

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Функции CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory и LookupIconIdFromDirectoryEx позволяют приложениям оболочки и браузерам значков проверять и использовать ресурсы в системе.

Функция CreateIconFromResource вызывает CreateIconFromResourceEx , передавая в LR_DEFAULTSIZE|LR_SHARED качестве флагов.

Вызовите DestroyIcon для значков или DestroyCursor для курсоров, созданных с помощью CreateIconFromResource.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

См. также раздел

Основные понятия

CreateIconFromResourceEx

CreateIconIndirect

GetIconInfo

Значки

LoadResource

LookupIconIdFromDirectory

LookupIconIdFromDirectoryEx

Справочные материалы