Fungsi GetSysColorBrush (winuser.h)
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) |