Поделиться через

макрос ImageList_LoadBitmap (commctrl.h)

  • Статья

Вызывает функцию ImageList_LoadImage для создания списка изображений из указанного ресурса растрового изображения.

Синтаксис

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

Параметры

hi

Тип: HINSTANCE

Дескриптор экземпляра, содержащего ресурс растрового изображения. Этот параметр null при загрузке растрового изображения OEM.

lpbmp

Тип: LPCTSTR

Образ, который нужно загрузить. Если параметр hi не являетсяNULL, lpbmp — это адрес строки, завершающей значение NULL, которая содержит имя ресурса изображения в модуле hi. Если NULL, LOWORD этого параметра должен быть идентификатором битового изображения OEM для загрузки. Чтобы создать это значение, используйте макрос MAKEINTRESOURCE с одним из идентификаторов растровых карт OEM, определенных в WINUSER.H. Эти идентификаторы имеют префикс OBM_.

cx

Тип: int

Ширина каждого изображения. Высота каждого изображения и начального числа изображений определяется измерениями указанного растрового изображения.

cGrow

Тип: int

Количество изображений, по которым может расти список изображений, когда система должна освободить место для новых образов. Этот параметр представляет количество новых изображений, которые может содержать список измененных изображений.

crMask

Тип: COLORREF

Цвет, используемый для создания маски. Каждый пиксель этого цвета в указанном растровом рисунке изменяется на черный, а соответствующий бит в маске имеет значение 1. Если этот параметр является значением CLR_NONE, маска не создается.

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

Тип: HIMAGELIST

Возвращает дескриптор списка изображений в случае успешного выполнения или null в противном случае.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка commctrl.h