Método Image::SelectActiveFrame (gdiplusheaders.h)

Artigo
08/24/2023

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