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

Статья
05/25/2023

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

Чтобы указать нужную высоту или ширину, используйте функцию 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