CImageList::Add

Статья
06/10/2015

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

int Add( 
   CBitmap* pbmImage, 
   CBitmap* pbmMask  
); 
int Add( 
   CBitmap* pbmImage, 
   COLORREF crMask  
); 
int Add( 
   HICON hIcon  
);

Параметры

pbmImage
Указатель в растровое изображение, содержащий изображение или изображений. Количество изображений выводится из ширина растрового изображения.
pbmMask
Указатель в растровое изображение, содержащий маску. Если маска не используется со списком образа, то этот параметр, чтобы пропустить.
crMask
Цвет, используемый для создания маски. Каждая точка этого цвета в заданном растровом изображении изменить, чтобы черный и соответствующий бит в маске устанавливается равным единице.
hIcon
Дескриптор значка, содержащий растровое изображение и маску для нового образа.

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

Индекс, начинающийся с нуля первого нового образа, если успешно; в противном случае – 1.

Заметки

Ответственность за освободить дескриптор значка по завершении с ним.

Пример

// Add my icons.
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
m_myImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON2));

// Add my bitmap, make all black pixels transparent.
CBitmap bm;
bm.LoadBitmap(IDB_BITMAP1);
m_myImageList.Add(&bm, RGB(0, 0, 0));