Método Image::SelectActiveFrame (gdiplusheaders.h)
El método Image::SelectActiveFrame selecciona el marco de este objeto Image especificado por una dimensión y un índice.
Sintaxis
Status SelectActiveFrame(
[in] const GUID *dimensionID,
[in] UINT frameIndex
);
Parámetros
[in] dimensionID
Tipo: GUID const*
Puntero a un GUID que especifica la dimensión de marco. Los GUIDque identifican varias dimensiones de marco se definen en Gdiplusimaging.h.
[in] frameIndex
Tipo: UINT
Entero que especifica el índice del marco dentro de la dimensión de marco especificada.
Valor devuelto
Tipo: Estado
Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .
Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .
Comentarios:
Al llamar al método Image::SelectActiveFrame , se descartan todos los cambios realizados en el marco activo anteriormente. Si desea conservar los cambios realizados en un marco, llame al método Save antes de cambiar a otro fotograma.
Entre todos los formatos de imagen admitidos actualmente por GDI+, los únicos formatos que admiten imágenes de varios fotogramas son GIF y TIFF. Al llamar al método Image::SelectActiveFrame en una imagen GIF, debe usar FrameDimensionTime. Al llamar al método Image::SelectActiveFrame en una imagen TIFF, debe usar FrameDimensionPage.
Requisitos
| Cliente mínimo compatible | Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | gdiplusheaders.h (include Gdiplus.h) |
| Library | Gdiplus.lib |
| Archivo DLL | Gdiplus.dll |