Metodo Image::SelectActiveFrame (gdiplusheaders.h)

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

Vedi anche

Encoderparameter

Encoderparameters

GetImageEncoders

Immagine

Metodi Image::Save

Image::SaveAdd Metodi

Uso di codificatori di immagini e decodificatori