Image：：SelectActiveFrame 方法 (gdiplusheaders.h)

项目
08/24/2023

Image：：SelectActiveFrame 方法选择由维度和索引指定的此 Image 对象中的帧。

语法

Status SelectActiveFrame(
  [in] const GUID *dimensionID,
  [in] UINT       frameIndex
);

parameters

[in] dimensionID

类型： const GUID*

指向指定帧尺寸的 GUID 的指针。用于标识各种帧尺寸的 GUID在 Gdiplusimaging.h 中定义。

[in] frameIndex

类型： UINT

指定指定帧维度内的帧索引的整数。

返回值

类型：状态

如果该方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

备注

调用 Image：：SelectActiveFrame 方法时，将放弃对以前活动帧所做的所有更改。如果要保留对帧所做的更改，请在切换到其他帧之前调用 Save 方法。

在 GDI+ 当前支持的所有图像格式中，支持多帧图像的唯一格式是 GIF 和 TIFF。在 GIF 图像上调用 Image：：SelectActiveFrame 方法时，应使用 FrameDimensionTime。在 TIFF 图像上调用 Image：：SelectActiveFrame 方法时，应使用 FrameDimensionPage。

要求


最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdiplusheaders.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll