commctrl.h
ImageList_LoadImage
La función ImageList_LoadImage crea una lista de imágenes desde el recurso de mapa de bits, cursor o especificado.
Sintaxis
HIMAGELIST ImageList_LoadImage(
HINSTANCE hi,
LPCSTR lpbmp,
int cx,
int cGrow,
COLORREF crMask,
UINT uType,
UINT uFlags
);
Parámetros
- hi
- Manipulador de la instancia que contiene el recurso.
- lpbmsp
- Puntero a una cadena terminada con cero que contiene el nombre de la imagen a cargar.
Si el parámetro uFlags especifica el valor LR_LOADFROMFILE, el parámetro lpbmp debe ser el nombre del fichero que contiene la imagen.
Si el parámetro hi es cero, la palabra de menor peso de este parámetro debe ser el identificador de una imagen OEM para cargar. Los identificadores de imagen OEM están definidos en WINUSER.H. A continuación se muestran los prefijos de los identificadores y sus significados:
Prefijo Significado OBM_ Mapas de bits OEM OIC_ Iconos OEM OCR_ Cursores OEM - cx
- Anchura de cada imagen. La altura de cada imagen y el número inicial de imágenes se calculan a partir de las dimensiones del mapa de bits especificado.
- cGrow
-
- Cantidad de imágenes en las que la lista de imágenes podrá agrandarse 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.
- crMask
- Color usado para generar una máscara. Cada pixel de este color en el mapa de bits especificado se cambia a negro, y el bit correspondiente en la máscara se asigna a uno. Si este parámetro es el valor CLR_NONE, no se genera máscara.
- uType
- Bandera que especifica el tipo de imagen a cargar. Este parámetro puede ser uno de los siguientes valores:
Valor Significado IMAGE_BITMAP Carga un mapa de bits. IMAGE_CURSOR Carga un cursor. IMAGE_ICON Carga un icono. - uFlags
- Banderas que especifican cómo cargar la imagen. Este parámetro puede ser una combinación de los siguientes valores:
Valor Significado LR_CREATEDIBSECTION Hace que la función devuelva una sección DIB de mapa de bits en lugar de un mapa de bits compatible cuando el parámetro uType especifique IMAGE_BITMAP. LR_CREATEDIBSECTION es útil para cargar mapas de bits sin mapearlos a los colores del dispositivo de visualización. LR_DEFAULTCOLOR Usa el formato de color del display. LR_DEFAULTSIZE Usa la anchura y altura especificados por los valores de medida del sistema para cursores e iconos si el parámetro cx es cero. Si este valor no se especifica y cx es cero, la función asigna el tamaño al especificado en el recurso. Si el recurso contiene múltiples imágenes, la función asigna el tamaño al de la primera imagen. LR_LOADFROMFILE Carga la imagen desde el fichero especificado por el parámetro lpbmp. LR_LOADMAP3DCOLORS Busca la tabla de colores para la imagen y reemplaza las siguientes sobras de grises con los colores tridimensionales correspondientes:
LR_LOADTRANSPARENT Recupera el valor de color del primer pixel de la imagen y reemplaza la entrada correspondiente de la tabla de colores con el color por defecto de ventana (el color de pantalla COLOR_WINDOW). Todos los pixeles de la imagen que usen esa entrada de color se convierten al valor de color de ventana por defecto. Este valor se aplica sólo a imágenes que tengan tablas de color correspondientes. LR_MONOCHROME Carga la imagen en blanco y negro. LR_SHARED Comparte el manipulador de imagen si la imagen es cargada varias veces. No usar este valor para imágenes que tengan tamaños no tradicionales que puedan cambiar después de cargarse o para imágenes que sean cargadas desde un fichero.
Valor de retorno
Si la función tiene éxito, el valor de retorno es la lista de imágenes.
Si la función falla, el valor de retorno es NULL.