Listas de imágenes

Esta sección contiene información sobre los elementos de programación usados con listas de imágenes.

Temas de introducción

Tema	Contenido
Listas de imágenes	Una lista de imágenes es una colección de imágenes del mismo tamaño, a las que puede hacer referencia cada una de ellas por su índice.

Functions

Tema	Contenido
HIMAGELIST_QueryInterface	Recupera un puntero a un objeto IImageList o IImageList2 que corresponde al identificador HIMAGELIST de la lista de imágenes.
ImageList_Add	Agrega una imagen o imágenes a una lista de imágenes.
ImageList_AddMasked	Agrega una imagen o imágenes a una lista de imágenes, lo que genera una máscara a partir del mapa de bits especificado.
ImageList_BeginDrag	Comienza a arrastrar una imagen.
ImageList_CoCreateInstance	Crea una única instancia de una lista de imágenes y devuelve un puntero de interfaz a ella.
ImageList_Copy	Copia imágenes dentro de una lista de imágenes determinada.
ImageList_Create	Crea una nueva lista de imágenes.
ImageList_Destroy	Destruye una lista de imágenes.
ImageList_DragEnter	Muestra la imagen de arrastre en la posición especificada dentro de la ventana.
ImageList_DragLeave	Desbloquea la ventana especificada y oculta la imagen de arrastre, lo que permite actualizar la ventana.
ImageList_DragMove	Mueve la imagen que se arrastra durante una operación de arrastrar y colocar. Normalmente, se llama a esta función en respuesta a un mensaje de WM_MOUSEMOVE .
ImageList_DragShowNolock	Muestra u oculta la imagen que se está arrastrando.
ImageList_Draw	Dibuja un elemento de lista de imágenes en el contexto de dispositivo especificado.
ImageList_DrawEx	Dibuja un elemento de lista de imágenes en el contexto de dispositivo especificado. La función usa el estilo de dibujo especificado y combina la imagen con el color especificado.
ImageList_DrawIndirect	Dibuja una imagen de lista de imágenes basada en una estructura IMAGELISTDRAWPARAMS .
ImageList_Duplicate	Crea un duplicado de una lista de imágenes existente.
ImageList_EndDrag	Finaliza una operación de arrastre.
ImageList_GetBkColor	Recupera el color de fondo actual de una lista de imágenes.
ImageList_GetDragImage	Recupera la lista de imágenes temporales que se usa para la imagen de arrastre. La función también recupera la posición de arrastre actual y el desplazamiento de la imagen de arrastre en relación con la posición de arrastre.
ImageList_GetIcon	Crea un icono a partir de una imagen y máscara en una lista de imágenes.
ImageList_GetIconSize	Recupera las dimensiones de las imágenes de una lista de imágenes. Todas las imágenes de una lista de imágenes tienen las mismas dimensiones.
ImageList_GetImageCount	Recupera el número de imágenes de una lista de imágenes.
ImageList_GetImageInfo	Recupera información sobre una imagen.
ImageList_LoadImage	Crea una lista de imágenes a partir del mapa de bits especificado.
ImageList_Merge	Crea una nueva imagen combinando dos imágenes existentes. La función también crea una nueva lista de imágenes en la que se va a almacenar la imagen.
ImageList_Read	Lee una lista de imágenes de una secuencia.
ImageList_ReadEx	Lee una lista de imágenes de una secuencia y devuelve una interfaz a la lista de imágenes.
ImageList_Remove	Quita una imagen de una lista de imágenes.
ImageList_Replace	Reemplaza una imagen de una lista de imágenes por una nueva imagen.
ImageList_ReplaceIcon	Reemplaza una imagen por un icono o cursor.
ImageList_SetBkColor	Establece el color de fondo de una lista de imágenes. Esta función solo funciona si agrega un icono o usa ImageList_AddMasked con un mapa de bits blanco y negro. Sin máscara, se dibuja toda la imagen; por lo tanto, el color de fondo no está visible.
ImageList_SetColorTable	Establece la tabla de colores de una lista de imágenes.
ImageList_SetDragCursorImage	Crea una nueva imagen de arrastre combinando la imagen especificada (normalmente una imagen de cursor del mouse) con la imagen de arrastre actual.
ImageList_SetIconSize	Establece las dimensiones de las imágenes de una lista de imágenes y quita todas las imágenes de la lista.
ImageList_SetImageCount	Cambia el tamaño de una lista de imágenes existente.
ImageList_SetOverlayImage	Agrega una imagen especificada a la lista de imágenes que se van a usar como máscaras de superposición. Una lista de imágenes puede tener hasta cuatro máscaras de superposición en la versión 4.70 y anteriores y hasta 15 en la versión 4.71. La función asigna un índice de máscara de superposición a la imagen especificada.
ImageList_Write	Escribe una lista de imágenes en una secuencia.
ImageList_WriteEx	Escribe una lista de imágenes en una secuencia.

Macros

Tema	Contenido
ImageList_AddIcon	Agrega un icono o cursor a una lista de imágenes. ImageList_AddIcon llama a la función ImageList_ReplaceIcon .
ImageList_ExtractIcon	Llama a la función ImageList_GetIcon para crear un icono o cursor basado en una imagen y máscara en una lista de imágenes.
ImageList_LoadBitmap	Llama a la función ImageList_LoadImage para crear una lista de imágenes a partir del recurso de mapa de bits especificado.
ImageList_RemoveAll	Llama a la función ImageList_Remove para quitar todas las imágenes de una lista de imágenes.
INDEXTOOVERLAYMASK	Prepara el índice de una máscara de superposición para que la función ImageList_Draw pueda usarla.

Interfaces

Tema	Contenido
IImageList	Expone métodos que manipulan e interactúan con listas de imágenes. Para usar IImageList, especifique Comctl32.dll versión 6 en el manifiesto. Si no lo hace, Comctl32.dll versión 5 se usará de forma predeterminada, con lo que IImageList podría mostrar un comportamiento impredecible. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

Métodos

Tema	Contenido
Sumar	Agrega una imagen o imágenes a una lista de imágenes.
AddMasked	Agrega una imagen o imágenes a una lista de imágenes, lo que genera una máscara a partir del mapa de bits especificado.
BeginDrag	Comienza a arrastrar una imagen.
Clon	Clona una lista de imágenes existente.
Copiar	Copia imágenes de una lista de imágenes determinada.
DragEnter	Bloquea las actualizaciones de la ventana especificada durante una operación de arrastre y muestra la imagen de arrastre en la posición especificada dentro de la ventana.
DragLeave	Desbloquea la ventana especificada y oculta la imagen de arrastre, lo que permite actualizar la ventana.
DragMove	Mueve la imagen que se arrastra durante una operación de arrastrar y colocar. Normalmente se llama a esta función en respuesta a un mensaje de WM_MOUSEMOVE .
DragShowNolock	Muestra u oculta la imagen que se está arrastrando.
Dibujar	Dibuja un elemento de lista de imágenes en el contexto de dispositivo especificado.
EndDrag	Finaliza una operación de arrastre.
GetBkColor	Obtiene el color de fondo actual de una lista de imágenes.
GetDragImage	Obtiene la lista de imágenes temporales que se usa para la imagen de arrastre. La función también recupera la posición de arrastre actual y el desplazamiento de la imagen de arrastre en relación con la posición de arrastre.
GetIcon	Crea un icono a partir de una imagen y una máscara en una lista de imágenes.
GetIconSize	Obtiene las dimensiones de las imágenes de una lista de imágenes. Todas las imágenes de una lista de imágenes tienen las mismas dimensiones.
GetImageCount	Obtiene el número de imágenes de una lista de imágenes.
GetImageInfo	Obtiene información sobre una imagen.
GetImageRect	Obtiene el rectángulo delimitador de una imagen.
GetItemFlags	Obtiene las marcas de una imagen.
GetOverlayImage	Recupera una imagen especificada de la lista de imágenes usadas como máscaras de superposición.
Merge	Crea una nueva imagen combinando dos imágenes existentes. Este método también crea una nueva lista de imágenes en la que se va a almacenar la imagen.
Quitar	Quita una imagen de una lista de imágenes.
Reemplazar	Reemplaza una imagen de una lista de imágenes por una nueva imagen.
ReplaceIcon	Reemplaza una imagen por un icono o cursor.
SetBkColor	Establece el color de fondo de una lista de imágenes. Este método solo funciona si agrega un icono a la lista de imágenes o usa el método IImageList::AddMasked para agregar un mapa de bits blanco y negro. Sin una máscara, toda la imagen dibuja y el color de fondo no es visible.
SetDragCursorImage	Crea una nueva imagen de arrastre combinando la imagen especificada, que normalmente es una imagen de cursor del mouse, con la imagen de arrastre actual.
SetIconSize	Establece las dimensiones de las imágenes de una lista de imágenes y quita todas las imágenes de la lista.
SetImageCount	Cambia el tamaño de una lista de imágenes existente.
SetOverlayImage	Agrega una imagen especificada a la lista de imágenes usadas como máscaras de superposición. Una lista de imágenes puede tener hasta cuatro máscaras de superposición en Common Controls versión 4.70 y anteriores, y hasta 15 en la versión 4.71 o posterior. El método asigna un índice de máscara de superposición a la imagen especificada.

Estructuras

Tema	Contenido
IMAGEINFO	Contiene información sobre una imagen en una lista de imágenes. Esta estructura se usa con la función IImageList::GetImageInfo .
IMAGELISTDRAWPARAMS	Contiene información sobre una operación de dibujo de lista de imágenes y se usa con la función IImageList::D raw .