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

Substitui o quadro atual por uma nova imagem.

Sintaxe

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Parâmetros

[in] pImg

Tipo: Imagem*

O endereço da nova imagem.

Retornar valor

Tipo: HRESULT

Sempre retorna S_OK.

Comentários

Você também deve chamar IShellImageData::D iscardEdit para garantir que todas as propriedades editadas da imagem original não sejam retidas.

No caso de uma imagem multiframada, como um arquivo .gif, o quadro atual é substituído. No caso de imagens não multiframadas, como um arquivo .jpg, toda a imagem é substituída.

Substituir um quadro em um arquivo de .gif animado faz com que a animação desse arquivo não esteja mais funcional. Substituir um quadro em um arquivo TIFF (Formato de Arquivo de Imagem Marcada) pode fazer com que esse arquivo perca páginas, especialmente se a imagem do quadro TIFF não tiver o mesmo tamanho do original. Se possível, você sempre deve substituir a imagem de um quadro TIFF por um TIFF do mesmo tamanho.

A implementação IShellImageData assume a propriedade da imagem chamada em pImg e o chamador não deve tentar usá-la depois de chamar IShellImageData::ReplaceFrame.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shimgdata.h
DLL	Shell32.dll