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


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

Извлекает сведения о указанном значке или курсоре.

Синтаксис

BOOL GetIconInfo(
  [in]  HICON     hIcon,
  [out] PICONINFO piconinfo
);

Параметры

[in] hIcon

Тип: HICON

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

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

[out] piconinfo

Тип: PICONINFO

Указатель на структуру ICONINFO . Функция заполняет элементы структуры.

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

Тип: BOOL

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

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

Комментарии

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

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-gui-l1-1-0 (представлено в Windows 8)

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

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

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

Значки

DeleteObject

GetObject

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

CreateIcon

CreateIconFromResource

CreateIconIndirect

DestroyIcon

DrawIcon

DrawIconEx

LoadIcon

LookupIconIdFromDirectory

ICONINFO