Fungsi SelectPalette (wingdi.h)

Artikel
03/04/2024

Fungsi SelectPalette memilih palet logis yang ditentukan ke dalam konteks perangkat.

Sintaks

HPALETTE SelectPalette(
  [in] HDC      hdc,
  [in] HPALETTE hPal,
  [in] BOOL     bForceBkgd
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] hPal

Handel ke palet logis yang akan dipilih.

[in] bForceBkgd

Menentukan apakah palet logis dipaksa menjadi palet latar belakang. Jika nilai ini TRUE, fungsi RealizePalette menyebabkan palet logis dipetakan ke warna yang sudah ada di palet fisik dengan cara terbaik. Ini selalu dilakukan, bahkan jika jendela tempat palet direalisasikan milik utas tanpa fokus aktif.

Jika nilai ini FALSE, RealizePalette menyebabkan palet logis disalin ke palet perangkat saat aplikasi berada di latar depan. (Jika parameter hdc adalah konteks perangkat memori, parameter ini diabaikan.)

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke palet logika konteks perangkat sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL.

Keterangan

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

Aplikasi dapat memilih palet logis ke dalam lebih dari satu konteks perangkat hanya jika konteks perangkat kompatibel. Jika tidak , SelectPalette gagal. Untuk membuat konteks perangkat yang kompatibel dengan konteks perangkat lain, panggil CreateCompatibleDC dengan konteks perangkat pertama sebagai parameter . Jika palet logis dipilih ke lebih dari satu konteks perangkat, perubahan pada palet logis akan memengaruhi semua konteks perangkat yang dipilihnya.

Aplikasi mungkin memanggil fungsi SelectPalette dengan parameter bForceBackground diatur ke TRUE jika jendela anak dari jendela tingkat atas masing-masing menyadari palet mereka sendiri. Namun, hanya jendela anak yang perlu mewujudkan paletnya yang harus mengatur bForceBackground ke TRUE; jendela anak lainnya harus mengatur nilai ini ke FALSE.

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