Compartir a través de

Método IShellImageData::ReplaceFrame (shimgdata.h)

  • Artículo

Reemplaza el marco actual por una nueva imagen.

Sintaxis

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Parámetros

[in] pImg

Tipo: Imagen*

Dirección de la nueva imagen.

Valor devuelto

Tipo: HRESULT

Siempre devuelve S_OK.

Comentarios

También debe llamar a IShellImageData::D iscardEdit para asegurarse de que las propiedades editadas de la imagen original no se conservan.

En el caso de una imagen multiframed, como un archivo .gif, se reemplaza el marco actual. En el caso de imágenes no multiframed como un archivo de .jpg, se reemplaza toda la imagen.

Reemplazar un fotograma en un archivo de .gif animado hace que la animación del archivo ya no sea funcional. Reemplazar un marco en un archivo de formato de archivo de imagen etiquetada (TIFF) podría hacer que el archivo pierda páginas, especialmente si la imagen del marco TIFF no tiene el mismo tamaño que el original. Si es posible, siempre debe reemplazar la imagen de un marco TIFF por un TIFF del mismo tamaño.

La implementación de IShellImageData toma posesión de la imagen denominada en pImg y el autor de la llamada no debe intentar usarlo después de llamar a IShellImageData::ReplaceFrame.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shimgdata.h
Archivo DLL Shell32.dll