Fungsi SetBkColor (wingdi.h)

Artikel
08/27/2023

Fungsi SetBkColor mengatur warna latar belakang saat ini ke nilai warna yang ditentukan, atau ke warna fisik terdekat jika perangkat tidak dapat mewakili nilai warna yang ditentukan.

Sintaks

COLORREF SetBkColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

Parameter

[in] hdc

Handel ke konteks perangkat.

[in] color

Warna latar belakang baru. Untuk membuat nilai COLORREF , gunakan makro RGB .

Menampilkan nilai

Jika fungsi berhasil, nilai pengembalian menentukan warna latar belakang sebelumnya sebagai nilai COLORREF .

Jika fungsi gagal, nilai yang dikembalikan adalah CLR_INVALID.

Keterangan

Fungsi ini mengisi celah antara garis gaya yang digambar menggunakan pena yang dibuat oleh fungsi CreatePen ; ini tidak mengisi celah antara garis gaya yang digambar menggunakan pena yang dibuat oleh fungsi ExtCreatePen . Fungsi SetBkColor juga mengatur warna latar belakang untuk TextOut dan ExtTextOut.

Jika mode latar belakang OPAQUE, warna latar belakang digunakan untuk mengisi celah antara garis bergaya, celah antara garis yang menetas dalam kuas, dan sel karakter. Warna latar belakang juga digunakan saat mengonversi bitmap dari warna ke monokrom dan sebaliknya.

Contoh

Misalnya, lihat "Contoh Item Menu Owner-Drawn" di Menggunakan Menu.

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