wglGetLayerPaletteEntries (wingdi.h)

Artikel
03/09/2024

Mengambil entri palet dari bidang lapisan indeks warna tertentu untuk konteks perangkat tertentu.

Sintaks

int wglGetLayerPaletteEntries(
  HDC      unnamedParam1,
  int      unnamedParam2,
  int      unnamedParam3,
  int      unnamedParam4,
  COLORREF *unnamedParam5
);

Parameter

unnamedParam1

Jenis: HDC

Konteks perangkat jendela yang bidang lapisannya akan dijelaskan.

unnamedParam2

Jenis: int

Bidang overlay atau underlay. Nilai positif iLayerPlane mengidentifikasi bidang overlay, di mana 1 adalah bidang overlay pertama di atas bidang utama, 2 adalah bidang overlay kedua di atas bidang overlay pertama, dan sebagainya. Nilai negatif mengidentifikasi bidang underlay, di mana 1 adalah bidang underlay pertama di bawah bidang utama, 2 adalah bidang underlay kedua di bawah bidang underlay pertama, dan sebagainya. Jumlah bidang overlay dan underlay diberikan dalam anggota bReserved dari struktur PIXELFORMATDESCRIPTOR .

unnamedParam3

Jenis: int

Entri palet pertama yang akan diambil.

unnamedParam4

Jenis: int

Jumlah entri palet yang akan diambil.

unnamedParam5

Jenis: COLORREF*

Array struktur yang berisi nilai warna RGB palet. Array harus berisi setidaknya struktur sebanyak yang ditentukan oleh cEntries.

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah entri yang diatur dalam palet di bidang lapisan jendela yang ditentukan.

Jika fungsi gagal atau ketika tidak ada format piksel yang dipilih, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Setiap bidang lapisan indeks warna di jendela memiliki palet dengan ukuran 2^n, di mana n adalah jumlah bidang bit di bidang lapisan. Anda tidak dapat mengubah indeks transparan palet.

Gunakan fungsi wglRealizeLayerPalette untuk mewujudkan palet lapisan. Awalnya palet lapisan hanya berisi entri untuk putih.

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
Pustaka	Opengl32.lib
DLL	Opengl32.dll