CImageList::Create

Статья
06/10/2015

Инициализирует список образа и вложение его к объекту Класс CImageList.

BOOL Create( 
   int cx, 
   int cy, 
   UINT nFlags, 
   int nInitial, 
   int nGrow  
); 
BOOL Create( 
   UINT nBitmapID, 
   int cx, 
   int nGrow, 
   COLORREF crMask  
); 
BOOL Create( 
   LPCTSTR lpszBitmapID, 
   int cx, 
   int nGrow, 
   COLORREF crMask  
); 
BOOL Create( 
   CImageList& imagelist1, 
   int nImage1, 
   CImageList& imagelist2, 
   int nImage2, 
   int dx, 
   int dy  
); 
BOOL Create( 
   CImageList* pImageList  
);

Параметры

cx
Измерения каждого изображения в пикселях.
cy
Измерения каждого изображения в пикселях.

nFlags
Определяет тип образа для создания списка. Этот параметр может быть сочетанием следующих значений, но он может включать только одно из значений ILC_COLOR.

Значение	Значение
ILC_COLOR	Используйте расширение функциональности по умолчанию, если не существует другого ILC_COLOR*, определенные флаги. Как правило, значение по умолчанию ILC_COLOR4; однако для более старых драйверов, значение по умолчанию ILC_COLORDDB.
ILC_COLOR4	Используйте 4-разрядный раздел файла DIB (16 цветов) как растровое изображение для списка изображений.
ILC_COLOR8	Используйте 8-разрядный раздел DIB. Цвет таблицы цветов те же цвета в качестве палитры полутонового изображения.
ILC_COLOR16	Используйте 16-разрядный (32-64 тыс. цветов) раздел DIB.
ILC_COLOR24	Используйте 24-разрядный DIB.
ILC_COLOR32	Используйте 32-разрядный раздел DIB.
ILC_COLORDDB	Растровое изображение устройство- используйте зависимые.
ILC_MASK	Использует маску. Список образа содержит 2 растрового изображения, один из которых определяет растровое изображение, используемое в качестве монохромного маска. Если это значение не указан, то список образа содержит только одно растровое изображение. Дополнительные сведения см. в разделе Рисование изображений из списка изображений на замаскированных образов.

nInitial
Количество изображений, которые изначально содержит список образа.
nGrow
Количество изображений, список завершения образа может увеличиваться при системе необходимо изменить размер списка, чтобы освободить место для новых изображений. Этот параметр представляет количество новых образов изменен список может содержать размерный образа.
nBitmapID
Идентификаторы ресурса растрового изображения, который необходимо связать со списком образа.
crMask
Цвет, используемый для создания маски. Каждая точка этого цвета в указанном растровом изображении изменить, чтобы черный и соответствующий бит в маске устанавливается равным единице.
lpszBitmapID
Строка, содержащая идентификаторы ресурсов изображений.
imagelist1
Ссылка на объект CImageList.
nImage1
Индекс первого существующего образа.
imagelist2
Ссылка на объект CImageList.
nImage2
Индекс второго существующего образа.
dx
Смещение по оси X второго образа в отношении к первому образу в пикселях.
dy
Смещение по оси Y второго образа в отношении к первому образу в пикселях.
pImageList
Указатель на объект CImageList.

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

Ненулевой, если успешно; в противном случае – значение 0.

Заметки

Построении CImageList в шаге 2. Во-первых, вызовите конструктор, и затем вызовите Create, который создает список образа и вложение его к объекту CImageList.

Пример

m_myImageList.Create(32, 32, ILC_COLOR8, 0, 4);

Требования

заголовок: afxcmn.h

См. также

Ссылки

Класс CImageList

Диаграмма иерархии

CImageList::CImageList

COLORREF

Рисование изображений из списка изображений

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