Compartir a través de


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

Reemplaza una imagen por un icono o cursor.

Sintaxis

HRESULT ReplaceIcon(
  [in]  int   i,
  [in]  HICON hicon,
  [out] int   *pi
);

Parámetros

[in] i

Tipo: int

Valor de tipo int que contiene el índice de la imagen que se va a reemplazar. Si i es -1, la función agrega la imagen al final de la lista.

[in] hicon

Tipo: HICON

Identificador del icono o cursor que contiene el mapa de bits y la máscara de la nueva imagen.

[out] pi

Tipo: int*

Puntero a un valor int que contendrá el índice de la imagen en la devolución si es correcto o -1 de lo contrario.

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

Dado que el sistema no guarda hicon, puede destruirlo después de que la función devuelva si CreateIcon creó el icono o el cursor. No es necesario destruir hicon si la función LoadIcon la cargó; el sistema libera automáticamente un recurso de icono cuando ya no es necesario.

Para usar IImageList::ReplaceIcon, 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)