Método Image::SelectActiveFrame (gdiplusheaders.h)
O método Image::SelectActiveFrame seleciona o quadro neste objeto Image especificado por uma dimensão e um índice.
Sintaxe
Status SelectActiveFrame(
[in] const GUID *dimensionID,
[in] UINT frameIndex
);
Parâmetros
[in] dimensionID
Tipo: const GUID*
Ponteiro para um GUID que especifica a dimensão do quadro. OS GUIDque identificam várias dimensões de quadro são definidos em Gdiplusimaging.h.
[in] frameIndex
Tipo: UINT
Inteiro que especifica o índice do quadro dentro da dimensão de quadro especificada.
Valor retornado
Tipo: Status
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
Quando você chama o método Image::SelectActiveFrame , todas as alterações feitas no quadro ativo anteriormente são descartadas. Se você quiser manter as alterações feitas em um quadro, chame o método Save antes de alternar para um quadro diferente.
Entre todos os formatos de imagem com suporte atualmente pelo GDI+, os únicos formatos que dão suporte a imagens de vários quadros são GIF e TIFF. Ao chamar o método Image::SelectActiveFrame em uma imagem GIF, você deve usar FrameDimensionTime. Ao chamar o método Image::SelectActiveFrame em uma imagem TIFF, você deve usar FrameDimensionPage.
Requisitos
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | gdiplusheaders.h (inclua Gdiplus.h) |
| Biblioteca | Gdiplus.lib |
| DLL | Gdiplus.dll |