Значение
Windows 2. x
0x00020000
Windows 3.x
0x00030000
Все Win 32 приложения должны использовать для иконок и курсоров формат Windows 3. x .
Возвращаемые значения
В случае успеха возвращается дескриптор иконки или курсора.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Функции CreateIconFromResource, CreateIconIndirect, GetIconInfo и LookupIconIdFromDirectory (в Windows 95 также функции CreateIconFromResourceEx и LookupIconIdFromDirectoryEx ) позволяют приложениям оболочки и браузерам иконок проверять и использовать ресурсы всей системы.
См. также
CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LoadResource, LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx .
CreateIconFromResourceEx
Функция CreateIconFromResourceEx создает иконку или курсор из битов ресурса, описывающих иконку.
HICON CreateIconFromResourceEx (
PBYTE pbIconBits , // указатель на биты ресурса
DWORD cbIconBits , // число бит в буфере
BOOL fIcon , // флаг иконки или курсора
DWORD dwVersion , // версия формата Windows
int cxDesired , // желаемая ширина иконки или курсора
int cyDesired , // желаемая высота иконки или курсора
UINT uFlags
);
Параметры
pbIconBits - указывает на буфер, содержащий биты ресурса иконки или курсора. Эти биты обычно загружаются вызовами функций LookupIconIdFromDirectory (в Windows 95 вы также можете использовать функцию LookupIconIdFromDirectoryEx ) и LoadResource .
cbIconBits - определяет размер, в байтах, набора битов, на который указывает параметр pbIconBits .
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. |