función ImageList_LoadImageA (commctrl.h)

Crea una lista de imágenes a partir del mapa de bits especificado.

Sintaxis

HIMAGELIST ImageList_LoadImageA(
  HINSTANCE hi,
  LPCSTR    lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

Parámetros

hi

Tipo: HINSTANCE

Identificador de la instancia que contiene el recurso. Este parámetro puede ser NULL si está cargando una imagen desde un archivo o cargando un recurso OEM.

lpbmp

Tipo: LPCTSTR de

Imagen que se va a cargar.

Si el parámetro uFlags incluye LR_LOADFROMFILE, lpbmp es la dirección de una cadena terminada en null que asigna un nombre al archivo que contiene la imagen que se va a cargar.

Si el parámetro hi no es NULL y no se especifica LR_LOADFROMFILE, lpbmp es la dirección de una cadena terminada en null que contiene el nombre del recurso de imagen en el módulo hi hi.

Si hi es NULL y no se especifica LR_LOADFROMFILE, el LOWORD de este parámetro debe ser el identificador de una imagen OEM que se va a cargar. Para crear este valor, use la macro MAKEINTRESOURCE con uno de los identificadores de imagen oem definidos en Winuser.h. Estos identificadores tienen los siguientes prefijos.

Valor	Significado
OBM_ para mapas de bits oem
OIC_ para iconos de OEM
OCR_ para cursores OEM

cx

Tipo: int

Ancho de cada imagen. Las dimensiones del recurso especificado deducen el alto de cada imagen y el número inicial de imágenes.

cGrow

Tipo: int

El número de imágenes por las que la lista de imágenes puede crecer cuando el sistema necesita espacio para nuevas imágenes. Este parámetro representa el número de imágenes nuevas que puede contener la lista de imágenes cambiadas de tamaño.

crMask

Tipo: COLORREF

Color usado para generar una máscara. Cada píxel de este color en el mapa de bits, el cursor o el icono especificados se cambia a negro y el bit correspondiente de la máscara se establece en 1. Si este parámetro es el valor de CLR_NONE, no se genera ninguna máscara. Si este parámetro es el valor de CLR_DEFAULT, el color del píxel en la esquina superior izquierda de la imagen se trata como color de máscara.

uType

Tipo: UINT de

Marca que especifica el tipo de imagen que se va a cargar. Este parámetro debe ser IMAGE_BITMAP para indicar que se está cargando un mapa de bits.

NotaImageList_LoadImage solo se usa con archivos de mapa de bits. No se admite ningún otro tipo de imagen.

 

Valor	Significado
IMAGE_BITMAP	Carga un mapa de bits.

uFlags

Tipo: UINT de

Marcas 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 un mapa de bits de sección DIB en lugar de un mapa de bits compatible cuando el parámetro uType especifica IMAGE_BITMAP. LR_CREATEDIBSECTION es útil para cargar un mapa de bits sin asignarlo a los colores del dispositivo de visualización.
LR_DEFAULTCOLOR	Usa el formato de color de la pantalla.
LR_DEFAULTSIZE	Usa el ancho o alto especificado por los valores de métrica del sistema para cursores e iconos si el parámetro cx está establecido en cero. Si no se especifica este valor y cx se establece en cero, la función establece el tamaño en el especificado en el recurso. Si el recurso contiene varias imágenes, la función establece el tamaño en el de la primera imagen.
LR_LOADFROMFILE	Carga la imagen del archivo especificado por el parámetro lpbmp.
LR_LOADMAP3DCOLORS	Busca en la tabla de colores la imagen y reemplaza los siguientes tonos de gris por el color tridimensional correspondiente: Dk Gray: RGB(128, 128, 128)COLOR_3DSHADOW Gris: RGB(192, 192, 192)COLOR_3DFACE Lt Gray: RGB(223, 223, 223)COLOR_3DLIGHT Para obtener más información, vea la sección Comentarios.
LR_LOADTRANSPARENT	Recupera el valor de color del primer píxel de la imagen y reemplaza la entrada correspondiente de la tabla de colores por el color de la ventana predeterminado (el color de la pantalla COLOR_WINDOW). Todos los píxeles de la imagen que usan ese color se convierten en el color de valor de ventana predeterminado. Este valor solo se aplica a las imágenes que tienen una tabla de colores correspondiente. Para obtener más información, vea la sección Comentarios.
LR_MONOCHROME	Carga la imagen en blanco y negro.
LR_SHARED	Comparte el identificador de imagen si la imagen se carga varias veces. No use este valor para imágenes que tengan tamaños no tradicionales que puedan cambiar después de cargar o para las imágenes que se cargan desde un archivo.

Valor devuelto

Tipo: HIMAGELIST

Devuelve el identificador de la lista de imágenes si se ejecuta correctamente o null en caso contrario.

Observaciones

LR_LOADTRANSPARENT no carga la imagen de forma transparente. Crea una lista de imágenes opacas que solo aparece transparente porque todos los píxeles de fondo se han cambiado a COLOR_WINDOW. Si las imágenes se dibujan sobre un fondo que no es el color COLOR_WINDOW, la imagen no dibuja correctamente. Además, LR_LOADTRANSPARENT y LR_LOADMAP3DCOLORS usan los colores del sistema que estaban en vigor en el momento en que se llamó a ImageList_LoadImage. Si los colores del sistema cambian posteriormente, la aplicación debe volver a cargar la imagen para volver a asignar los colores.

Nota

El encabezado commctrl.h define ImageList_LoadImage como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h
biblioteca de	Comctl32.lib
DLL de	Comctl32.dll

Consulte también

LoadImage