Fungsi EnumMetaFile (wingdi.h)

Artikel
03/04/2024

Fungsi EnumMetaFile menghitung rekaman dalam metafile format Windows dengan mengambil setiap rekaman dan meneruskannya ke fungsi panggilan balik yang ditentukan. Fungsi panggilan balik yang disediakan aplikasi memproses setiap rekaman sesuai kebutuhan. Enumerasi berlanjut hingga rekaman terakhir diproses atau ketika fungsi panggilan balik mengembalikan nol.

Catatan Fungsi ini disediakan hanya untuk kompatibilitas dengan metafil format Windows. Metafil format yang disempurnakan menyediakan fungsionalitas yang unggul dan direkomendasikan untuk aplikasi baru. Fungsi yang sesuai untuk metafile format yang disempurnakan adalah EnumEnhMetaFile.

Sintaks

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Parameter

[in] hdc

Menangani konteks perangkat. Handel ini diteruskan ke fungsi panggilan balik.

[in] hmf

Menangani metafile format Windows.

[in] proc

Penunjuk ke fungsi panggilan balik yang disediakan aplikasi. Untuk informasi selengkapnya, lihat EnumMetaFileProc.

[in] param

Arahkan ke data opsional.

Nilai kembali

Jika fungsi panggilan balik berhasil menghitung semua rekaman dalam metafile format Windows, nilai yang dikembalikan bukan nol.

Jika fungsi panggilan balik tidak berhasil menghitung semua rekaman dalam metafile format Windows, nilai yang dikembalikan adalah nol.

Keterangan

Untuk mengonversi metafile format Windows menjadi metafile format yang disempurnakan, gunakan fungsi SetWinMetaFileBits .

Anda dapat menggunakan fungsi EnumMetaFile untuk menyematkan satu metafile format Windows di dalam metafile lain.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	wingdi.h (sertakan Windows.h)
Pustaka	Gdi32.lib
DLL	Gdi32.dll