Gambar::Metode SelectActiveFrame (gdiplusheaders.h)

Artikel
08/24/2023

Metode Image::SelectActiveFrame memilih bingkai dalam objek Gambar ini yang ditentukan oleh dimensi dan indeks.

Sintaks

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

Parameter

[in] dimensionID

Jenis: const GUID*

Penunjuk ke GUID yang menentukan dimensi bingkai. GUIDyang mengidentifikasi berbagai dimensi bingkai didefinisikan dalam Gdiplusimaging.h.

[in] frameIndex

Jenis: UINT

Bilangan bulat yang menentukan indeks bingkai dalam dimensi bingkai yang ditentukan.

Menampilkan nilai

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Saat Anda memanggil metode Image::SelectActiveFrame , semua perubahan yang Anda buat pada bingkai yang sebelumnya aktif akan dibuang. Jika Anda ingin mempertahankan perubahan yang Anda buat pada bingkai, panggil metode Simpan sebelum Anda beralih ke bingkai yang berbeda.

Di antara semua format gambar yang saat ini didukung oleh GDI+, satu-satunya format yang mendukung gambar multi-bingkai adalah GIF dan TIFF. Saat Anda memanggil metode Image::SelectActiveFrame pada gambar GIF, Anda harus menggunakan FrameDimensionTime. Saat Anda memanggil metode Image::SelectActiveFrame pada gambar TIFF, Anda harus menggunakan FrameDimensionPage.

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusheaders.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll