Compartir a través de


Método IImageList::SetOverlayImage (commoncontrols.h)

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.

Sintaxis

HRESULT SetOverlayImage(
  [in] int iImage,
  [in] int iOverlay
);

Parámetros

[in] iImage

Tipo: int

Valor de tipo int que contiene el índice de base cero de una imagen en la lista de imágenes. Este índice identifica la imagen que se va a usar como máscara de superposición.

[in] iOverlay

Tipo: int

Valor de tipo int que contiene el índice basado en uno de la máscara de superposición.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

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 IImageList::D raw. 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.

Para usar IImageList::SetOverlayImage, especifique Comctl32.dll versión 6 en el manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

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 commoncontrols.h
Archivo DLL Comctl32.dll (versión 6.0 o posterior)