Русский справочник по Win32 API

fIcon– определяет, будет ли создаваться иконка или курсор. Если значение этого параметра равно TRUE, создается иконка. Иначе создается курсор.

dwVersion– определяет номер версии формата иконки или курсора для битов ресурса, на которые указывает параметр pbIconBits . Параметр может принимать одно из следующих значений:

Формат	Значение
Windows 2. x	0x00020000
Windows 3.x	0x00030000

Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .

cxDesired– определяет желаемую ширину иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки ширины.

cyDesired– определяет желаемую высоту иконки или курсора в пикселях. Если значение этого параметра равно нулю, функция использует значения метрики системы SM _ CXICON или SM _ CXCURSOR для установки высоты.

uFlags– определяет комбинацию из следующих значений:

Значение	Пояснение
LR _ DEFAULTCOLOR	Используется цветовой формат по умолчанию.
LR _ MONOCHROME	Создается монохромная иконка или курсор.

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

В случае успеха возвращается дескриптор иконки или курсора.

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

Комментарии

Функции CreateIconFromResourceEx, CreateIconFromResource , CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectoryEx позволяют приложениям оболочки и браузерам иконок проверять и использовать ресурсы всей системы.

См. также

BITMAPINFOHEADER, CreateIconFromResource, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectoryEx .

CreateIconIndirect

Функция CreateIconIndirect создает иконку или курсор по информации из структуры типа ICONINFO .

HICON CreateIconIndirect (

PICONINFO piconinfo // указатель на структуру с

// информацией об иконке

);

Параметры

piconinfo– указывает на структуру типа ICONINFO , которую функция использует для создания иконки или курсора.

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

В случае успеха возвращается дескриптор созданной иконки или курсора.

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

Комментарии

Система копирует битовые образы в структуру типа ICONINFO перед созданием иконки или курсора. Приложение должно продолжать управлять исходными битовыми образами и удалить их при отсутствии в них дальнейшей необходимости.

Когда вы закончили использовать иконку, вызовите функцию DestroyIcon .

См . также

DestroyIcon, ICONINFO .

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 .