IShellImageData::ReplaceFrame-Methode (shimgdata.h)

Ersetzt den aktuellen Frame durch ein neues Bild.

Syntax

HRESULT ReplaceFrame(
  [in] Image *pImg
);

Parameter

[in] pImg

Typ: Image*

Die Adresse des neuen Images.

Rückgabewert

Typ: HRESULT

Gibt immer S_OK zurück.

Hinweise

Sie sollten auch IShellImageData::D iscardEdit aufrufen, um sicherzustellen, dass bearbeitete Eigenschaften des ursprünglichen Bilds nicht beibehalten werden.

Bei einem mehrteiligen Bild, z. B. einer .gif-Datei, wird der aktuelle Frame ersetzt. Bei Nicht-Multiframe-Bildern wie einer .jpg-Datei wird das gesamte Bild ersetzt.

Wenn Sie einen Frame in einer animierten .gif Datei ersetzen, ist die Animation dieser Datei nicht mehr funktionsfähig. Das Ersetzen eines Frames in einer TIFF-Datei (Tagged Image File Format) kann dazu führen, dass diese Datei Seiten verliert, insbesondere wenn das Bild des TIFF-Frames nicht die gleiche Größe wie das Original aufweist. Wenn möglich, sollten Sie das Bild eines TIFF-Frames immer durch ein TIFF der gleichen Größe ersetzen.

Die IShellImageData-Implementierung übernimmt den Besitz des Images mit dem Namen in pImg , und der Aufrufer sollte nicht versuchen, es nach dem Aufruf von IShellImageData::ReplaceFrame zu verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shimgdata.h
DLL	Shell32.dll