Поделиться через


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

Извлекает сведения об указанном значке или курсоре. 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

См. также раздел

Основные понятия

Растровые изображения

Значки

DeleteObject

GetObject

РАСТРОВОГО ИЗОБРАЖЕНИЯ

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO