Compartir a través de


CImageList::Create

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