Image：：SelectActiveFrame 方法 (gdiplusheaders.h)

發行項
08/24/2023

Image：：SelectActiveFrame方法會選取維度和索引所指定此Image物件中的框架。

語法

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

參數

[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)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll