Función ImageList_SetOverlayImage (commctrl.h)

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.

Sintaxis

BOOL ImageList_SetOverlayImage(
  [in] HIMAGELIST himl,
  [in] int        iImage,
  [in] int        iOverlay
);

Parámetros

[in] himl

Tipo: HIMAGELIST

Identificador de la lista de imágenes.

[in] iImage

Tipo: int

Índice de base cero de una imagen en la lista de imágenes himl . Este índice identifica la imagen que se va a usar como máscara de superposición.

[in] iOverlay

Tipo: int

Índice basado en uno de la máscara de superposición.

Valor devuelto

Tipo: BOOL

Devuelve un valor distinto de cero si se ejecuta correctamente o cero en caso contrario.

Comentarios

Una máscara de superposición es una imagen dibujada de forma transparente sobre otra imagen. Para dibujar una máscara de superposición sobre una imagen, llame a la función ImageList_Draw o ImageList_DrawEx . El parámetro fStyle de estas funciones puede usar la macro INDEXTOOVERLAYMASK para especificar un índice de máscara de superposición.

Se produce un error en una llamada a este método y devuelve E_INVALIDARG a menos que se cree la lista de imágenes mediante una máscara.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll
Conjunto de API	ext-ms-win-shell-comctl32-init-l1-1-1 (introducido en Windows 10, versión 10.0.14393)