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

Voir aussi

EncoderParameter

EncoderParameters

GetImageEncoders

Image

Image::Save, méthodes

Image::SaveAdd, méthodes

Utilisation d’encodeurs et de décodeurs d’image