Fungsi UpdateColors (wingdi.h)

Artikel
27/08/2023

Fungsi UpdateColors memperbarui area klien dari konteks perangkat yang ditentukan dengan memetakan ulang warna saat ini di area klien ke palet logis yang saat ini direalisasikan.

Sintaks

BOOL UpdateColors(
  [in] HDC hdc
);

Parameter

[in] hdc

Handel ke konteks perangkat.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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.

Jendela tidak aktif dengan palet logis yang diwujudkan dapat memanggil UpdateColors sebagai alternatif untuk menggambar ulang area kliennya ketika palet sistem berubah.

Fungsi UpdateColors biasanya memperbarui area klien lebih cepat daripada menggambar ulang area. Namun, karena UpdateColors melakukan terjemahan warna berdasarkan warna setiap piksel sebelum palet sistem berubah, setiap panggilan ke fungsi ini menghasilkan hilangnya beberapa akurasi warna.

Fungsi ini harus dipanggil segera setelah pesan WM_PALETTECHANGED diterima.

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