Image::SelectActiveFrame-Methode (gdiplusheaders.h)

2023-08-24

Die Image::SelectActiveFrame-Methode wählt den Frame in diesem Image-Objekt aus, das durch eine Dimension und einen Index angegeben wird.

Syntax

Status SelectActiveFrame(
  [in] const GUID *dimensionID,
  [in] UINT       frameIndex
);

Parameter

[in] dimensionID

Typ: const GUID*

Zeiger auf eine GUID , die die Framedimension angibt. GUIDs, die verschiedene Framedimensionen identifizieren, werden in Gdiplusimaging.h definiert.

[in] frameIndex

Typ: UINT

Ganzzahl, die den Index des Frames innerhalb der angegebenen Framedimension angibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Anmerkungen

Wenn Sie die Image::SelectActiveFrame-Methode aufrufen, werden alle Änderungen verworfen, die Sie am zuvor aktiven Frame vorgenommen haben. Wenn Sie Änderungen beibehalten möchten, die Sie an einem Frame vornehmen, rufen Sie die Save-Methode auf, bevor Sie zu einem anderen Frame wechseln.

Unter allen Bildformaten, die derzeit von GDI+ unterstützt werden, sind GIF und TIFF die einzigen Formate, die Mehrframebilder unterstützen. Wenn Sie die Image::SelectActiveFrame-Methode für ein GIF-Bild aufrufen, sollten Sie FrameDimensionTime verwenden. Wenn Sie die Image::SelectActiveFrame-Methode für ein TIFF-Image aufrufen, sollten Sie FrameDimensionPage verwenden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusheaders.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll