commctrl.h


ImageList_Create

La función ImageList_Create crea una nueva lista de imágenes.

Sintaxis

HIMAGELIST ImageList_Create(
    int cx, 	
    int cy, 	
    UINT flags, 	
    int cInitial, 	
    int cGrow	
   );

Parámetros

cx
Especifica la anchura, en pixels, de cada imagen.
cy
Especifica la altura, en pixels, de cada imagen.
flags
Un conjunto de banderas de bit que especifican el tipo de lista de imágenes a crear. Este parámetro puede ser una combinación de los siguientes valores, pero sólo puede incluir uno de los valores ILC_COLOR.
Valor Significado
ILC_COLOR Usa el comportamiento por defecto si no se especifica ninguna de las otras banderas ILC_COLOR*. Generalmente, el valor por defecto es ILC_COLOR4; pero para drivers gráficos antiguos, el valor por defecto es ILC_COLORDDB.
ILC_COLOR4 Usa una sección de mapa de bits independiente del dispositivo (DIB) de 4-bit (16 colores) (DIB) como el mapa de bits para la lista de imágenes.
ILC_COLOR8 Usa una sección DIB de 8-bit. Los colores usados para la tabla de colores son los mismos colores que para la paleta de medios tonos.
ILC_COLOR16 Usa una sección DIB de 16-bit (32/64k colores).
ILC_COLOR24 Usa una sección DIB de 24-bit.
ILC_COLOR32 Usa uans ección DIB de 32-bit.
ILC_COLORDDB Usa un mapa de bits dependiente del dispositivo.
ILC_MASK Usa una máscara. La lista de imágenes contiene dos mapas de bits, uno de ellos es un mapa de bits monocromo usado como una máscara. Si este valor no está incluido, la lista de imágenes contiene sólo un mapa de bits.
cInitial
Número de imágenes que contiene inicialmente la lista de imágenes.
cGrow
Cantidad de imágenes en la que la lista de imágenes puede crecer cuando el sistema necesite redimensionar la lista para hacer sitio para nuevas imágenes. Este parámetro representa el número de nuevas imágenes que la lista de imágenes redimensionada puede contener.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador de la lista de imágenes.

Si la función falla, el valor de retorno es NULL.