CImageList::Create

Artículo
02/19/2013

Inicializa una imagen lista y lo asocia a un objeto de Clase de 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 
);

Parámetros

cx
dimensiones de cada imagen, en píxeles.
cy
dimensiones de cada imagen, en píxeles.

nFlags
especifica el tipo de lista de la imagen para crear.este parámetro puede ser una combinación de los valores siguientes, pero puede incluir solamente uno de los valores de ILC_COLOR .

Valor	Significado
ILC_COLOR	Utilice el comportamiento predeterminado si ninguno de otro ILC_COLOR* se especifican los marcadores.Normalmente, el valor predeterminado es ILC_COLOR4; pero para controladores de vídeo más antiguos, el valor predeterminado es ILC_COLORDDB.
ILC_COLOR4	Utilice una sección de mapa de bits independiente del dispositivo de 4 bits (16 colores (DIB)) como el mapa de bits para la lista de imágenes.
ILC_COLOR8	Utilice una sección de 8 bits DIB.Los colores utilizados para la paleta de colores son los mismos colores que la tabla de semitono.
ILC_COLOR16	Utilice (32/64k color) una sección de 16 bits DIB.
ILC_COLOR24	Utilice 24 secciones DIB de bits.
ILC_COLOR32	Utilice una sección de 32 bits DIB.
ILC_COLORDDB	Utilice un mapa de bits dependiente.
ILC_MASK	utiliza una máscara.La lista de imágenes contiene dos mapas de bits, uno de los cuales es un mapa de bits monocromo utilizado como máscara.Si este valor no se incluye, la lista de imágenes sólo contiene un mapa de bits.Vea Gráfico Imágenes de una lista de Imágenes para obtener más información sobre las imágenes enmascaradas.

nInitial
Número de imágenes que la imagen que aparece inicialmente contiene.
nGrow
Número de imágenes por las que la lista de imágenes puede crecer cuando el sistema necesita cambiar el tamaño de la lista para hacer sitio para las nuevas imágenes.Este parámetro representa el número de nuevas imágenes que la lista devuelven el tamaño de la imagen puede contener.
nBitmapID
Id. de recurso de mapa de bits a asociar a la lista de imágenes.
crMask
Color de una máscara.Cada píxel de este color en el mapa de bits especificado se cambia a negro, y el bit correspondiente de la máscara se establece en una.
lpszBitmapID
Una cadena que contiene los id. de recurso de imágenes.
imagelist1
Una referencia a un objeto CImageList.
nImage1
índice de la primera imagen existente.
imagelist2
Una referencia a un objeto CImageList.
nImage2
índice de la segunda imagen existente.
dx
Desplazamiento del eje X de la segunda imagen en la relación a la primera imagen, en píxeles.
dy
Desplazamiento del eje Y la segunda imagen en la relación a la primera imagen, en píxeles.
pImageList
un puntero a un objeto de CImageList .

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

Crea CImageList en dos pasos.Primero, llame al constructor y llame a Create, que crea la imagen mostrada y la agrega al objetode CImageList.

Ejemplo

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

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

Clase de CImageList

Gráfico de jerarquía

CImageList::CImageList

COLORREF

Gráfico Imágenes de una lista de Imágenes

Share via