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

Written on . Posted in Win32

ОГЛАВЛЕНИЕ

Страница 20 из 30

Функция 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
Уникод     Нет 
Замечания по платформе   Не имеется

c++ форум