Win32 API. Пиктограммы
Страница 20. Функция GetIconInfo


Функция GetIconInfo

(ПолучитьИнформациюПиктограммы)

Функция GetIconInfo получает информацию о заданной пиктограмме или курсору.

Синтаксис

BOOL GetIconInfo
(
HICON hIcon,// дескриптор пиктограммы
PICONINFO piconinfo // адрес структуры пиктограммы
);

Параметры
Идентифицирует пиктограмму или курсор. Чтобы получить информацию о стандартной пиктограмме или курсору, определите одно из следующих значений:

  • IDC_ARROW - Курсор в виде стрелки
  • IDC_IBEAM - Курсор в виде прямой линии – I
  • IDC_WAIT - Курсор в виде песочных часов
  • IDC_CROSS - Курсор в виде креста
  • IDC_UPARROW - Курсор в виде стрелки вверх
  • IDC_SIZENWSE - Установка размеров курсором, указывает на северо-запад и юго-восток
  • IDC_SIZENESW - Установка размеров курсором, указывает на северо-восток и юго-запад
  • IDC_SIZEWE - Установка размеров курсором, указывает на запад и восток
  • IDC_SIZENS - Установка размеров курсором, указывает на север и юг
  • IDC_SIZEALL - Установка размеров курсором, указывает на север, юг, восток, и запад
  • IDC_NO - Курсор "Нет"
  • IDC_APPSTARTING - Курсор запуска приложения (стрелка и песочные часы)
  • IDC_HELP - Курсор справки (стрелка и знак вопроса)
  • IDI_APPLICATION - Пиктограмма приложения
  • IDI_HAND - Пиктограмма с сигналом "Стоп"
  • IDI_QUESTION - Пиктограмма со знаком вопроса
  • IDI_EXCLAMATION - Пиктограмма со знаком восклицания
  • IDI_ASTERISK - Пиктограмма со звездочкой (буква "i" в круге)
  • IDI_WINLOGO - Пиктограмма с логотипом Windows

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

Возвращаемые значения
Если функция завершается успешно, величина возвращаемого значения отличная от нуля и функция заполняет элементы определяемой структуры ICONINFO.
Если функция не выполняет задачу, величина возвращаемого значения нулевая. Чтобы получать расширенные данные об ошибках, вызовите GetLastError.

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

Смотри также
CreateIcon, CreateIconFromResource, CreateIconIndirect, DestroyIcon, DrawIcon, DrawIconEx, ICONINFO, LoadIcon, LookupIconIdFromDirectory

Размещение и совместимость GetIconInfo

Windows NTДа 
Win95Да
Win32sДа
Импортируемая библиотекаuser32.lib
Заголовочный файлwinuser.h
УникодНет
Замечания по платформеНе имеется

 
« Предыдущая статья   Следующая статья »