Fungsi GetPaletteEntries (wingdi.h)

Artikel
08/27/2023

Fungsi GetPaletteEntries mengambil rentang entri palet tertentu dari palet logis yang diberikan.

Sintaks

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Parameter

[in] hpal

Handel ke palet logis.

[in] iStart

Entri pertama dalam palet logis yang akan diambil.

[in] cEntries

Jumlah entri dalam palet logis yang akan diambil.

[out] pPalEntries

Penunjuk ke array struktur PALETTEENTRY untuk menerima entri palet. Array harus berisi setidaknya struktur sebanyak yang ditentukan oleh parameter nEntries .

Menampilkan nilai

Jika fungsi berhasil dan handel ke palet logis adalah penunjuk yang valid (bukan NULL), nilai yang dikembalikan adalah jumlah entri yang diambil dari palet logis. Jika fungsi berhasil dan menangani palet logis adalah NULL, nilai yang dikembalikan adalah jumlah entri dalam palet yang diberikan.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Aplikasi dapat menentukan apakah perangkat mendukung operasi palet dengan memanggil fungsi GetDeviceCaps dan menentukan konstanta RASTERCAPS.

Jika parameter nEntries menentukan lebih banyak entri daripada yang ada di palet, anggota struktur PALETTEENTRY yang tersisa tidak diubah.

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