Fungsi GetEnhMetaFilePaletteEntries (wingdi.h)

Artikel
03/08/2023

Fungsi GetEnhMetaFilePaletteEntries mengambil entri palet opsional dari metafile yang ditingkatkan yang ditentukan.

Sintaks

UINT GetEnhMetaFilePaletteEntries(
  [in]  HENHMETAFILE   hemf,
  [in]  UINT           nNumEntries,
  [out] LPPALETTEENTRY lpPaletteEntries
);

Parameter

[in] hemf

Handel ke metafile yang ditingkatkan.

[in] nNumEntries

Jumlah entri yang akan diambil dari palet opsional.

[out] lpPaletteEntries

Penunjuk ke array struktur PALETTEENTRY yang menerima warna palet. Array harus berisi setidaknya struktur sebanyak ada entri yang ditentukan oleh parameter cEntries .

Menampilkan nilai

Jika penunjuk array adalah NULL dan metafile yang disempurnakan berisi palet opsional, nilai yang dikembalikan adalah jumlah entri dalam palet metafile yang disempurnakan; jika penunjuk array adalah penunjuk yang valid dan metafile yang disempurnakan berisi palet opsional, nilai yang dikembalikan adalah jumlah entri yang disalin; jika metafile tidak berisi palet opsional, nilai yang dikembalikan adalah nol. Jika tidak, nilai yang dikembalikan GDI_ERROR.

Keterangan

Aplikasi dapat menyimpan palet opsional dalam metafile yang disempurnakan dengan memanggil fungsi CreatePalette dan SetPaletteEntries sebelum membuat gambar dan menyimpannya di metafile. Dengan melakukan ini, aplikasi dapat mencapai warna yang konsisten ketika gambar ditampilkan di berbagai perangkat.

Aplikasi yang menampilkan gambar yang disimpan dalam metafile yang disempurnakan dapat memanggil fungsi GetEnhMetaFilePaletteEntries untuk menentukan apakah palet opsional ada. Jika ya, aplikasi dapat memanggil fungsi GetEnhMetaFilePaletteEntries untuk kedua kalinya untuk mengambil entri palet dan kemudian membuat palet logis (dengan menggunakan fungsi CreatePalette ), memilihnya ke dalam konteks perangkatnya (dengan menggunakan fungsi SelectPalette ), lalu mewujudkannya (dengan menggunakan fungsi RealizePalette ). Setelah palet logis direalisasikan, memanggil fungsi PlayEnhMetaFile menampilkan gambar menggunakan warna aslinya.

Persyaratan


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