Функция GetIconInfo


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

Синтаксис

BOOL GetIconInfo(

    HICON hIcon,
    PICONINFO piconinfo
);

Параметры

hIcon

[in] Дескриптор значка или курсора. Чтобы извлечь информацию о стандартном значке или курсоре, определите одно из ниже перечисленных значений.

Флажок Описание
IDC_APPSTARTING Стандартная стрелка и маленький курсор в форме песочных часов.
IDC_ARROW Стандартный курсор в форме стрелки.
IDC_CROSS Курсор в форме перекрестия.
IDC_HAND Windows 98/Me, Windows 2000/XP: Курсор в форме руки.
IDC_HELP Курсор в форме стрелки и вопросительного знака.
IDC_IBEAM Курсор в форме двутавра.
IDC_NO Курсор в форме перечеркнутого круга.
IDC_SIZEALL Курсор в форме четырехконечной стрелки, указывающий север, юг, восток и запад.
IDC_SIZENESW Курсор в форме двухконечной стрелки, указывающий северо-восток и юго-запад.
IDC_SIZENS Курсор в форме двухконечной стрелки, указывающий север и юг.
IDC_SIZENWSE Курсор в форме двухконечной стрелки, указывающий северо-запад и юго-восток.
IDC_SIZEWE Курсор в форме двухконечной стрелки, указывающий запад и восток.
IDC_UPARROW Курсор в форме вертикальной стрелки
IDC_WAIT Курсор в форме песочных часов.
IDI_APPLICATION Значок приложения.
IDI_ASTERISK Значок в форме звездочки.
IDI_EXCLAMATION Значок в форме восклицательного знака
IDI_HAND Значок в форме сигнала "Стоп!".
IDI_QUESTION Значок в форме вопросительного знака.
IDI_WINLOGO Значок логотипа Windows. Windows XP: Значок приложения.

piconinfo

[out] Указатель на структуру ICONINFO. Функция заполняет члены этой структуры.

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

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

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

Замечания

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

Смотри также

Обзор Значки, Функции, используемые значками, CreateIcon, CreateIconFromResource, CreateIconIndirect, DestroyIcon, DrawIcon, DrawIconEx, ICONINFO, LoadIcon, LookupIconIdFromDirectory

Размещение и совместимость GetIconInfo
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Да версии 3.1 и выше
е Windows Me Да
н Windows 98 Да
т Windows 95 Да
С Windows 2003 Server Да
е Windows 2000 Server Да
р Windows NT Server Да версии 3.1 и выше
в
е
р
Используемая библиотека User32.lib
Используемая DLL user32.dll
Заголовочный файл
- объявлено в Winuser.h
- включено в Windows.h
Unicode
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz