GetIconInfo

GetIconInfo

Функция GetIconInfo извлекает информацию об указанной иконке или курсоре.

BOOL GetIconInfo (

HICON hIcon , дескриптор иконки

PICONINFO piconinfo // адрес структуры иконки

);

Параметры

hIcon - идентифицирует иконку или курсор. Для извлечения информации о стандартной иконке или курсоре, укажите одно из следующих значений:

Значение

Описание

IDC _ ARROW

Обычный курсор-стрелка.

IDC _ IBEAM

Курсор в виде буквы " I ".

IDC _ WAIT

Курсор "большие песочные часы".

IDC _ CROSS

Курсор-перекрестие.

IDC _ UPARROW

Курсор "стрелка вверх".

IDC _ SIZE

Только Windows NT : четырехконечная стрелка

IDC _ ICON

Только Windows NT : пустая иконка.

IDC _ SIZENWSE

Курсор изменения размера. Ориентирован с северо-запада на юго-восток.

IDC _ SIZENESW

Курсор изменения размера. Ориентирован с северо-востока на юго-запад.

IDC _ SIZEWE

Горизонтальный курсор изменения размера.

IDC _ SIZENS

Вертикальный курсор изменения размера.

IDC _ SIZEALL

Курсор изменения всех размеров. То же, что и IDC _ SIZE.

IDC _ NO

Перечеркнутый наискосок круг.

IDC _ APPSTARTING

Курсор "маленькие песочные часы со стрелкой".

IDI _ APPLICATION

Иконка приложения по умолчанию.

IDI _ ASTERISK

Звездочка (используется в информационных сообщениях).

IDI _ EXCLAMATION

Восклицательный знак (используется в предупредительных сообщениях).

IDI _ HAND

Иконка, имеющая форму руки (используется в серьезных предупредительных сообщениях).

IDI _ QUESTION

Вопросительный знак (используется в вопросительных сообщениях).

IDI_WINLOGO

Лого Windows.

piconinfo - указывает на структуру типа ICONINFO . Функция заполняет члены структуры.

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

В случае успеха возвращается ненулевое значение, и функция заполняет члены структуры типа ICONINFO .

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

Комментарии

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

См. также

CreateIcon, CreateIconFromResource, CreateIconIndirect, DestroyIcon, DrawIcon, DrawIconEx, ICONINFO, LoadIcon, LookupIconIdFromDirectory .