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