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

Статья
03/13/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. На возвращаемые выходные данные не влияет разрешение вызывающего потока.

Примечание

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

Требования

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