Image::SelectActiveFrame-Methode (gdiplusheaders.h)
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 |