Fungsi GetSysColorBrush (winuser.h)

Artikel
03/04/2024

Fungsi GetSysColorBrush mengambil handel yang mengidentifikasi kuas logis yang sesuai dengan indeks warna yang ditentukan.

Sintaks

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Parameter

[in] nIndex

Indeks warna. Nilai ini sesuai dengan warna yang digunakan untuk melukis salah satu elemen jendela. Lihat GetSysColor untuk nilai indeks warna sistem.

Nilai kembali

Nilai yang dikembalikan mengidentifikasi kuas logis jika parameter nIndex didukung oleh platform saat ini. Jika tidak, ia mengembalikan NULL.

Keterangan

Kuas adalah bitmap yang digunakan sistem untuk mengecat interior bentuk yang terisi. Aplikasi dapat mengambil warna sistem saat ini dengan memanggil fungsi GetSysColor . Aplikasi dapat mengatur warna sistem saat ini dengan memanggil fungsi SetSysColors .

Aplikasi tidak boleh mendaftarkan kelas jendela untuk jendela menggunakan kuas sistem. Untuk mendaftarkan kelas jendela dengan warna sistem, lihat dokumentasi anggota hbrBackground dari struktur WNDCLASS atau WNDCLASSEX .

Kuas warna sistem melacak perubahan warna sistem. Dengan kata lain, ketika pengguna mengubah warna sistem, kuas warna sistem terkait secara otomatis berubah menjadi warna baru.

Untuk melukis dengan kuas warna sistem, aplikasi harus menggunakan GetSysColorBrush (nIndex) alih-alih CreateSolidBrush ( GetSysColor (nIndex)), karena GetSysColorBrush mengembalikan sikat cache alih-alih mengalokasikan yang baru.

Kuas warna sistem dimiliki oleh sistem sehingga Anda tidak perlu menghancurkannya. Meskipun Anda tidak perlu menghapus kuas logis yang dikembalikan GetSysColorBrush , tidak ada bahaya yang terjadi dengan memanggil DeleteObject.

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	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-gui-l1-1-1 (diperkenalkan dalam Windows 8.1)