Metodo Image::SelectActiveFrame (gdiplusheaders.h)

Articolo
08/24/2023

Il metodo Image::SelectActiveFrame seleziona il frame in questo oggetto Image specificato da una dimensione e un indice.

Sintassi

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

Parametri

[in] dimensionID

Tipo: GUID const*

Puntatore a un GUID che specifica la dimensione del frame. GUIDche identifica varie dimensioni del frame sono definite in Gdiplusimaging.h.

[in] frameIndex

Tipo: UINT

Intero che specifica l'indice del frame all'interno della dimensione frame specificata.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, ovvero un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Osservazioni:

Quando si chiama il metodo Image::SelectActiveFrame , tutte le modifiche apportate al frame attivo precedentemente vengono rimosse. Se si desidera conservare le modifiche apportate a un frame, chiamare il metodo Save prima di passare a un frame diverso.

Tra tutti i formati di immagine attualmente supportati da GDI+, gli unici formati che supportano più immagini frame sono GIF e TIFF. Quando si chiama il metodo Image::SelectActiveFrame in un'immagine GIF, è consigliabile usare FrameDimensionTime. Quando si chiama il metodo Image::SelectActiveFrame in un'immagine TIFF, è consigliabile usare FrameDimensionPage.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdiplusheaders.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll