Bagikan melalui


Fungsi SetBkColor (wingdi.h)

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

Lihat juga

COLORREF

CreatePen

ExtCreatePen

GetBKColor

GetBkMode

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

SetBkMode