Image::SelectActiveFrame, méthode (gdiplusheaders.h)
La méthode Image::SelectActiveFrame sélectionne le cadre dans cet objet Image spécifié par une dimension et un index.
Syntaxe
Status SelectActiveFrame(
[in] const GUID *dimensionID,
[in] UINT frameIndex
);
Paramètres
[in] dimensionID
Type : const GUID*
Pointeur vers un GUID qui spécifie la dimension frame. Les GUIDqui identifient différentes dimensions de frame sont définis dans Gdiplusimaging.h.
[in] frameIndex
Type : UINT
Entier qui spécifie l’index du frame dans la dimension de frame spécifiée.
Valeur retournée
Type : État
Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .
Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .
Remarques
Lorsque vous appelez la méthode Image::SelectActiveFrame , toutes les modifications que vous avez apportées à l’image précédemment active sont ignorées. Si vous souhaitez conserver les modifications que vous apportez à un frame, appelez la méthode Save avant de basculer vers un autre frame.
Parmi tous les formats d’image actuellement pris en charge par GDI+, les seuls formats qui prennent en charge les images à plusieurs images sont GIF et TIFF. Lorsque vous appelez la méthode Image::SelectActiveFrame sur une image GIF, vous devez utiliser FrameDimensionTime. Lorsque vous appelez la méthode Image::SelectActiveFrame sur une image TIFF, vous devez utiliser FrameDimensionPage.
Configuration requise
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | gdiplusheaders.h (inclure Gdiplus.h) |
| Bibliothèque | Gdiplus.lib |
| DLL | Gdiplus.dll |