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

Artículo
08/24/2023

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