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

Статья
03/13/2024

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

Синтаксис

HICON CreateIconFromResourceEx(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Параметры

[in] presbits

Тип: PBYTE

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

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

[in] dwResSize

Тип: DWORD

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

[in] fIcon

Тип: BOOL

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

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

[in] dwVer

Тип: DWORD

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

[in] cxDesired

Тип: int

Ширина значка или курсора (в пикселях). Если этот параметр равен нулю и параметр FlagsLR_DEFAULTSIZE, функция использует значение системной метрики SM_CXICON или SM_CXCURSOR для задания ширины. Если этот параметр равен нулю и LR_DEFAULTSIZE не используется, функция использует фактическую ширину ресурса.

[in] cyDesired

Тип: int

Высота значка или курсора (в пикселях). Если этот параметр равен нулю и параметр FlagsLR_DEFAULTSIZE, функция использует значение системной метрики SM_CYICON или SM_CYCURSOR для задания высоты. Если этот параметр равен нулю и LR_DEFAULTSIZE не используется, функция использует фактическую высоту ресурса.

[in] Flags

Тип: UINT

Сочетание следующих значений.

Значение	Значение
LR_DEFAULTCOLOR 0x00000000	Использует формат цвета по умолчанию.
LR_DEFAULTSIZE 0x00000040	Использует ширину или высоту, заданные значениями системных метрик для курсоров или значков, если значения cxDesired или cyDesired равны нулю. Если этот флаг не указан, а для cxDesired и cyDesired задано значение 0, функция использует фактический размер ресурса.
LR_MONOCHROME 0x00000001	Создает монохромный значок или курсор.
LR_SHARED 0x00008000	Предоставляет общий доступ к значку или маркеру курсора, если значок или курсор создаются несколько раз. Если LR_SHARED не задано, второй вызов CreateIconFromResourceEx для того же ресурса снова создаст значок или курсор и вернет другой дескриптор. При использовании этого флага система уничтожает ресурс, когда он больше не нужен. Не используйте LR_SHARED для значков или курсоров с нестандартными размерами, которые могут измениться после загрузки или загружены из файла.

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

Тип: HICON

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

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

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

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

Примеры

Пример см. в разделе Общий доступ к ресурсам значков.

Требования

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