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 .