Fungsi GetSysColor (winuser.h)

  • Artikel

Mengambil warna saat ini dari elemen tampilan yang ditentukan. Elemen tampilan adalah bagian dari jendela dan tampilan yang muncul di layar tampilan sistem.

Sintaks

DWORD GetSysColor(
  [in] int nIndex
);

Parameter

[in] nIndex

Jenis: int

Elemen tampilan yang warnanya akan diambil. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
COLOR_3DDKSHADOW
21
 Bayangan gelap untuk elemen tampilan tiga dimensi.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_3DFACE
15
 Warna wajah untuk elemen tampilan tiga dimensi dan untuk latar belakang kotak dialog.
COLOR_3DHIGHLIGHT
20
 Sorot warna untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap ke sumber cahaya.)

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_3DHILIGHT
20
 Sorot warna untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap ke sumber cahaya.)

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_3DLIGHT
22
 Warna terang untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap ke sumber cahaya.)

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_3DSHADOW
16
 Warna bayangan untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap jauh dari sumber cahaya).

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_ACTIVEBORDER
10
 Batas jendela aktif.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_ACTIVECAPTION
2
 Bilah judul jendela aktif.

Warna latar depan terkait COLOR_CAPTIONTEXT.

Menentukan warna sisi kiri dalam gradien warna bilah judul jendela aktif jika efek gradien diaktifkan.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_APPWORKSPACE
12
 Warna latar belakang beberapa aplikasi antarmuka dokumen (MDI).

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BACKGROUND
1
 Desktop.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BTNFACE
15
 Warna wajah untuk elemen tampilan tiga dimensi dan untuk latar belakang kotak dialog. Warna latar depan terkait COLOR_BTNTEXT.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BTNHIGHLIGHT
20
 Sorot warna untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap ke sumber cahaya.)

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BTNHILIGHT
20
 Sorot warna untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap ke sumber cahaya.)

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BTNSHADOW
16
 Warna bayangan untuk elemen tampilan tiga dimensi (untuk tepi yang menghadap jauh dari sumber cahaya).

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_BTNTEXT
18
 Teks pada tombol tekan. Warna latar belakang terkait COLOR_BTNFACE.
COLOR_CAPTIONTEXT
9
 Teks dalam caption, kotak ukuran, dan kotak panah bilah gulir. Warna latar belakang terkait COLOR_ACTIVECAPTION.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_DESKTOP
1
 Desktop.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_GRADIENTACTIVECAPTION
27
 Warna sisi kanan dalam gradien warna bilah judul jendela aktif. COLOR_ACTIVECAPTION menentukan warna sisi kiri. Gunakan SPI_GETGRADIENTCAPTIONS dengan fungsi SystemParametersInfo untuk menentukan apakah efek gradien diaktifkan.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_GRADIENTINACTIVECAPTION
28
 Warna sisi kanan dalam gradien warna bilah judul jendela yang tidak aktif. COLOR_INACTIVECAPTION menentukan warna sisi kiri.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_GRAYTEXT
17
 Teks abu-abu (dinonaktifkan). Warna ini diatur ke 0 jika pengandar tampilan saat ini tidak mendukung warna abu-abu pekat.
COLOR_HIGHLIGHT
13
 Item dipilih dalam kontrol. Warna latar depan terkait COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT
14
 Teks item dipilih dalam kontrol. Warna latar belakang terkait COLOR_HIGHLIGHT.
COLOR_HOTLIGHT
26
 Warna untuk hyperlink atau item terlacak panas. Warna latar belakang terkait COLOR_WINDOW.
COLOR_INACTIVEBORDER
11
 Batas jendela tidak aktif.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_INACTIVECAPTION
3
 Jendela tidak aktif caption.

Warna latar depan terkait COLOR_INACTIVECAPTIONTEXT.

Menentukan warna sisi kiri dalam gradien warna bilah judul jendela yang tidak aktif jika efek gradien diaktifkan.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_INACTIVECAPTIONTEXT
19
 Warna teks dalam caption tidak aktif. Warna latar belakang terkait COLOR_INACTIVECAPTION.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_INFOBK
24
 Warna latar belakang untuk kontrol tipsalat. Warna latar depan terkait COLOR_INFOTEXT.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_INFOTEXT
23
 Warna teks untuk kontrol tipsalat. Warna latar belakang terkait COLOR_INFOBK.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_MENU
4
 Latar belakang menu. Warna latar depan terkait COLOR_MENUTEXT.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_MENUHILIGHT
29
 Warna yang digunakan untuk menyoroti item menu saat menu muncul sebagai menu datar (lihat SystemParametersInfo). Item menu yang disorot diuraikan dengan COLOR_HIGHLIGHT.

Windows 2000, Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_MENUBAR
30
 Warna latar belakang untuk bilah menu saat menu muncul sebagai menu datar (lihat SystemParametersInfo). Namun, COLOR_MENU terus menentukan warna latar belakang popup menu.

Windows 2000, Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_MENUTEXT
7
 Teks dalam menu. Warna latar belakang terkait COLOR_MENU.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_SCROLLBAR
0
 Area abu-abu bilah gulir.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_WINDOW
5
 Latar belakang jendela. Warna latar depan terkait COLOR_WINDOWTEXT dan COLOR_HOTLITE.
COLOR_WINDOWFRAME
6
 Bingkai jendela.

Windows 10 atau lebih besar: Nilai ini tidak didukung.
COLOR_WINDOWTEXT
8
 Teks di jendela. Warna latar belakang terkait COLOR_WINDOW.

Nilai kembali

Jenis: DWORD

Fungsi mengembalikan nilai warna merah, hijau, biru (RGB) dari elemen yang diberikan.

Jika parameter nIndex berada di luar rentang, nilai yang dikembalikan adalah nol. Karena nol juga merupakan nilai RGB yang valid, Anda tidak dapat menggunakan GetSysColor untuk menentukan apakah warna sistem didukung oleh platform saat ini. Sebagai gantinya, gunakan fungsi GetSysColorBrush , yang mengembalikan NULL jika warna tidak didukung.

Keterangan

Untuk menampilkan komponen nilai RGB, gunakan makro GetRValue, GetGValue, dan GetBValue .

Warna sistem untuk tampilan monokrom biasanya ditafsirkan sebagai nuansa abu-abu.

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

Warna adalah elemen visual penting dari sebagian besar antarmuka pengguna. Untuk panduan tentang menggunakan warna dalam aplikasi Anda, lihat Warna - Win32 dan Warna dalam Windows 11.

Windows 10/11 warna sistem

Tabel ini memperlihatkan nilai yang didukung dalam Windows 10 dan Windows 11 dengan nilai warna dari tema kontras akuatik Windows 11.

Swatch warna Deskripsi

COLOR_WINDOWLatar belakang halaman, panel, popup, dan jendela.

Memasangkan dengan COLOR_WINDOWTEXT

COLOR_WINDOWTEXTJudul, salinan isi, daftar, teks tempat penampung, batas aplikasi dan jendela, UI apa pun yang tidak dapat berinteraksi.

Memasangkan dengan COLOR_WINDOW

COLOR_HOTLIGHTHyperlink.

Memasangkan dengan COLOR_WINDOW

COLOR_GRAYTEXTUI

tidak aktif (dinonaktifkan).Memasangkan dengan COLOR_WINDOW

COLOR_HIGHLIGHTTEXTWarna latar depan untuk teks atau UI yang dipilih, berinteraksi dengan (arahkan mouse, ditekan), atau sedang berlangsung.

Memasangkan dengan COLOR_HIGHLIGHT

COLOR_HIGHLIGHTLatar belakang atau warna aksen untuk UI yang dipilih, berinteraksi dengan (arahkan mouse, ditekan), atau sedang berlangsung.

Memasangkan dengan COLOR_HIGHLIGHTTEXT

COLOR_BTNTEXTWarna latar depan untuk tombol dan UI apa pun yang dapat berinteraksi.

Memasangkan dengan COLOR_3DFACE

COLOR_3DFACEWarna latar belakang untuk tombol dan UI apa pun yang dapat berinteraksi.

Memasangkan dengan COLOR_BTNTEXT

Gambar-gambar ini menunjukkan bagaimana warna muncul saat digunakan pada latar belakang yang diatur ke COLOR_WINDOW.

Contoh Nilai
Jendela dengan teks menggunakan warna teks jendela. COLOR_WINDOWTEXT
Jendela dengan teks hyperlink menggunakan warna terang panas. COLOR_HOTLIGHT
Jendela dengan teks tidak aktif menggunakan warna teks abu-abu. COLOR_GRAYTEXT
Jendela dengan teks menggunakan warna teks sorotan pada warna sorotan. COLOR_HIGHLIGHTTEXT + SOROTAN
Jendela dengan tombol menggunakan warna wajah 3d dan teks tombol menggunakan warna teks tombol. COLOR_BTNTEXT + COLOR_3DFACE

Contoh

Misalnya, lihat SetSysColors.

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 winuser.h (termasuk Windows.h)
Pustaka User32.lib
DLL User32.dll

Lihat juga

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo