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

Статья
11/20/2024

Извлекает сведения о указанном значке или курсоре. GetIconInfoEx расширяет GetIconInfo с помощью более новой структуры ICONINFOEX.

Синтаксис

BOOL GetIconInfoExA(
  [in]      HICON        hicon,
  [in, out] PICONINFOEXA piconinfo
);

Параметры

[in] hicon

Тип: HICON

Дескриптор значка или курсора.

Чтобы получить сведения о стандартном значке или курсоре, укажите идентификатор , начиная с префикса IDI_ или идентификатора , начиная с IDC_ префикса в этом параметре.

[in, out] piconinfo

Тип: PICONINFOEX

При возврате этого метода содержит указатель на структуру ICONINFOEX. Функция заполняет элементы структуры.

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

Тип: BOOL

TRUE указывает на успех, FALSE указывает на сбой.

Замечания

GetIconInfoEx создает растровые изображения для hbmMask и hbmColor или членов ICONINFOEX. Вызывающее приложение должно управлять этими растровыми изображениями и удалять их с помощью DeleteObject вызова, когда они больше не нужны.

виртуализация DPI

Этот API не участвует в виртуализации DPI. Возвращаемые выходные данные не влияют на DPI вызывающего потока.

Заметка

Заголовок winuser.h определяет GetIconInfoEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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