Fungsi SetDIBColorTable (wingdi.h)

Artikel
03/08/2023

Fungsi SetDIBColorTable mengatur nilai warna RGB (merah, hijau, biru) dalam rentang entri dalam tabel warna DIB yang saat ini dipilih ke dalam konteks perangkat tertentu.

Sintaks

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

Parameter

[in] hdc

Konteks perangkat. DIB harus dipilih ke dalam konteks perangkat ini.

[in] iStart

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

[in] cEntries

Jumlah entri tabel warna yang akan diatur.

[in] prgbq

Penunjuk ke array struktur RGBQUAD yang berisi informasi warna baru untuk tabel warna DIB.

Nilai kembali

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

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Fungsi ini harus dipanggil untuk mengatur tabel warna untuk DIB yang menggunakan 1, 4, atau 8 bpp. Anggota BitCount dari struktur header informasi bitmap terkait bitmap.

Struktur BITMAPINFOHEADER menentukan jumlah bit per piksel. Bitmap independen perangkat dengan nilai biBitCount yang lebih besar dari 8 tidak memiliki tabel warna.

Anggota bV5BitCount dari struktur BITMAPV5HEADER terkait bitmap menentukan jumlah bit per piksel. Bitmap independen perangkat dengan nilai bV5BitCount yang lebih besar dari 8 tidak memiliki tabel warna.

ICM: Tidak ada manajemen warna yang dilakukan.

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