Compartir a través de

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

  • Artículo

Reemplaza una imagen de una lista de imágenes por una nueva imagen.

Sintaxis

HRESULT Replace(
  [in]           int     i,
  [in]           HBITMAP hbmImage,
  [in, optional] HBITMAP hbmMask
);

Parámetros

[in] i

Tipo: int

Valor de tipo int que contiene el índice de la imagen que se va a reemplazar.

[in] hbmImage

Tipo: HBITMAP

Identificador del mapa de bits que contiene la imagen.

[in, optional] hbmMask

Tipo: HBITMAP

Identificador del mapa de bits que contiene la máscara. Si no se usa ninguna máscara con la lista de imágenes, este parámetro se omite.

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

IImageList::Replace copia el mapa de bits en una estructura de datos interna. Debe usar DeleteObject para eliminar hbmImage y hbmMask después de que el método devuelva.

Para usar IImageList::Replace, 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 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commoncontrols.h
Archivo DLL Comctl32.dll (versión 6.0 o posterior)