Здравствуйте, уважаемые подписчики. Перед вами очередной выпуск рассылки "WinAPI
на русском".
Сайт рассылки: http://www.winnt.rsm.org.ru. Материалы по Win32 API, C++Builder.
Раздел "WinAPI": http://www.winnt.rsm.org.ru/winapi/winapi.htm
Раздел "C++Builder": http://www.winnt.rsm.org.ru/cbuilder/cbuilder.htm
Раздел "Советы & примеры": http://www.winnt.rsm.org.ru/tipstricks/tipstricks.htm
Обновления на сайте
В раздел WinAPI добавилась книга "Азбука программирования в Win32 API"
Автор - Н. В. Румянцев. На русском языке. В pdf-формате
Перевод
Сегодня вашему вниманию представлен перевод функции CreateIconFromResourceEx.
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
Все Win32 приложения должны использовать для иконок и курсоров формат 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 .
хелп по WinAPI: http://www.winnt.rsm.org.ru/winapi/win32api.exe
С уважением,
ведущий рассылки
Тарас Сорока.
mailto:tnsoroka@online.ru