Fungsi GetDIBColorTable (wingdi.h)

Artikel
03/13/2024

Fungsi GetDIBColorTable mengambil nilai warna RGB (merah, hijau, biru) dari rentang entri dalam tabel warna bitmap bagian DIB yang saat ini dipilih ke dalam konteks perangkat tertentu.

Sintaks

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

Parameter

[in] hdc

Handel ke konteks perangkat. Bitmap bagian DIB harus dipilih ke dalam konteks perangkat ini.

[in] iStart

Indeks tabel warna berbasis nol yang menentukan entri tabel warna pertama yang akan diambil.

[in] cEntries

Jumlah entri tabel warna yang akan diambil.

[out] prgbq

Penunjuk ke buffer yang menerima array struktur data RGBQUAD yang berisi informasi warna dari tabel warna DIB. Buffer harus cukup besar untuk berisi struktur data RGBQUAD sebanyak nilai cEntries.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah entri tabel warna yang diambil fungsi.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi GetDIBColorTable harus dipanggil untuk mengambil tabel warna untuk bitmap bagian DIB yang menggunakan 1, 4, atau 8 bpp. Anggota biBitCount dari struktur BITMAPINFOHEADER terkait bitmap menentukan jumlah bit per piksel. Bitmap bagian DIB dengan nilai biBitCount yang lebih besar dari delapan tidak memiliki tabel warna, tetapi mereka memang memiliki masker warna terkait. Panggil fungsi GetObject untuk mengambil masker warna tersebut.

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