Metodo IShellImageData::ReplaceFrame (shimgdata.h)

Articolo
03/02/2024

Sostituisce il frame corrente con una nuova immagine.

Sintassi

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Parametri

[in] pImg

Tipo: Image*

Indirizzo della nuova immagine.

Valore restituito

Tipo: HRESULT

Restituisce sempre S_OK.

Commenti

È anche necessario chiamare IShellImageData::D iscardEdit per assicurarsi che le proprietà modificate dell'immagine originale non vengano mantenute.

Nel caso di un'immagine multiframe, ad esempio un file .gif, il frame corrente viene sostituito. Nel caso di immagini non multiframe, ad esempio un file .jpg, l'intera immagine viene sostituita.

La sostituzione di un frame in un file di .gif animato causa la mancata funzionalità dell'animazione del file. La sostituzione di un frame in un file TIFF (Tagged Image File Format) potrebbe causare la perdita di pagine del file, in particolare se l'immagine del frame TIFF non corrisponde alla stessa dimensione dell'originale. Se possibile, è sempre consigliabile sostituire l'immagine di un frame TIFF con un TIFF con le stesse dimensioni.

L'implementazione di IShellImageData acquisisce la proprietà dell'immagine denominata in pImg e il chiamante non deve provare a usarla dopo aver chiamato IShellImageData::ReplaceFrame.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shimgdata.h
DLL	Shell32.dll

Condividi tramite