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

Статья
11/20/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

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

[in] cyDesired

Тип: int

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

[in] Flags

Тип: UINT

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

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

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

Тип: HICON

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

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

Замечания

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

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

Примеры

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll