Функция GetIconInfoExW (winuser.h)
Извлекает сведения о указанном значке или курсоре. GetIconInfoEx расширяет getIconInfo с помощью новой структуры ICONINFOEX .
Синтаксис
BOOL GetIconInfoExW(
[in] HICON hicon,
[in, out] PICONINFOEXW 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 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
См. также раздел
Основные понятия