Image::SelectActiveFrame, méthode (gdiplusheaders.h)

Article
08/24/2023

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