GetSysColor-Funktion (winuser.h)

Ruft die aktuelle Farbe des angegebenen Anzeigeelements ab. Anzeigeelemente sind die Teile eines Fensters und die Anzeige, die auf dem Systemanzeigebildschirm angezeigt wird.

Syntax

DWORD GetSysColor(
  [in] int nIndex
);

Parameter

[in] nIndex

Typ: int

Das Anzeigeelement, dessen Farbe abgerufen werden soll. Dieser Parameter kann einer der folgenden Werte sein:

Value Bedeutung
COLOR_3DDKSHADOW
21
 Dunkler Schatten für dreidimensionale Anzeigeelemente.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DFACE
15
 Gesichtsfarbe für dreidimensionale Anzeigeelemente und für Dialogfeldhintergründe.
COLOR_3DHIGHLIGHT
20
 Hervorhebungsfarbe für dreidimensionale Anzeigeelemente (für Ränder, die der Lichtquelle gegenüberstehen.)

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DHILIGHT
20
 Hervorhebungsfarbe für dreidimensionale Anzeigeelemente (für Ränder, die der Lichtquelle gegenüberstehen.)

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DLIGHT
22
 Helle Farbe für dreidimensionale Anzeigeelemente (für Kanten, die der Lichtquelle gegenüberstehen.)

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DSHADOW
16
 Schattenfarbe für dreidimensionale Anzeigeelemente (für Ränder, die von der Lichtquelle entfernt sind).

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_ACTIVEBORDER
10
 Aktiver Fensterrahmen.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_ACTIVECAPTION
2
 Titelleiste des aktiven Fensters.

Die zugeordnete Vordergrundfarbe ist COLOR_CAPTIONTEXT.

Gibt die linke Seitenfarbe im Farbverlauf der Titelleiste eines aktiven Fensters an, wenn der Farbverlaufseffekt aktiviert ist.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_APPWORKSPACE
12
 Hintergrundfarbe mehrerer MDI-Anwendungen (Document Interface).

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BACKGROUND
1
 Desktop:

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNFACE
15
 Gesichtsfarbe für dreidimensionale Anzeigeelemente und für Dialogfeldhintergründe. Die zugeordnete Vordergrundfarbe ist COLOR_BTNTEXT.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNHIGHLIGHT
20
 Hervorhebungsfarbe für dreidimensionale Anzeigeelemente (für Ränder, die der Lichtquelle gegenüberstehen.)

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNHILIGHT
20
 Hervorhebungsfarbe für dreidimensionale Anzeigeelemente (für Ränder, die der Lichtquelle gegenüberstehen.)

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNSHADOW
16
 Schattenfarbe für dreidimensionale Anzeigeelemente (für Ränder, die von der Lichtquelle entfernt sind).

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNTEXT
18
 Text auf Knopfdruck. Die zugeordnete Hintergrundfarbe ist COLOR_BTNFACE.
COLOR_CAPTIONTEXT
9
 Text in Beschriftungs-, Größenfeld- und Bildlaufleistenpfeilfeld. Die zugeordnete Hintergrundfarbe ist COLOR_ACTIVECAPTION.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_DESKTOP
1
 Desktop:

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_GRADIENTACTIVECAPTION
27
 Rechte Seitenfarbe im Farbverlauf der Titelleiste eines aktiven Fensters. COLOR_ACTIVECAPTION gibt die linke Seitenfarbe an. Verwenden Sie SPI_GETGRADIENTCAPTIONS mit der SystemParametersInfo-Funktion , um zu bestimmen, ob der Farbverlaufseffekt aktiviert ist.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_GRADIENTINACTIVECAPTION
28
 Rechte Seitenfarbe im Farbverlauf der Titelleiste eines inaktiven Fensters. COLOR_INACTIVECAPTION gibt die linke Seitenfarbe an.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_GRAYTEXT
17
 Abgeblenter (deaktivierter) Text. Diese Farbe ist auf 0 festgelegt, wenn der aktuelle Anzeigetreiber keine Volltongraufarbe unterstützt.
COLOR_HIGHLIGHT
13
 Elemente, die in einem Steuerelement ausgewählt sind. Die zugeordnete Vordergrundfarbe ist COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT
14
 Text von Elementen, die in einem Steuerelement ausgewählt sind. Die zugeordnete Hintergrundfarbe ist COLOR_HIGHLIGHT.
COLOR_HOTLIGHT
26
 Farbe für ein Hyperlink- oder Hottracked-Element. Die zugeordnete Hintergrundfarbe ist COLOR_WINDOW.
COLOR_INACTIVEBORDER
11
 Inaktiver Fensterrahmen.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_INACTIVECAPTION
3
 Inaktive Fensterbeschriftung.

Die zugeordnete Vordergrundfarbe ist COLOR_INACTIVECAPTIONTEXT.

Gibt die linke Seitenfarbe im Farbverlauf der Titelleiste eines inaktiven Fensters an, wenn der Farbverlaufseffekt aktiviert ist.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_INACTIVECAPTIONTEXT
19
 Farbe von Text in einer inaktiven Beschriftung. Die zugeordnete Hintergrundfarbe ist COLOR_INACTIVECAPTION.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_INFOBK
24
 Hintergrundfarbe für QuickInfo-Steuerelemente. Die zugeordnete Vordergrundfarbe ist COLOR_INFOTEXT.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_INFOTEXT
23
 Textfarbe für QuickInfo-Steuerelemente. Die zugeordnete Hintergrundfarbe ist COLOR_INFOBK.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_MENU
4
 Menühintergrund. Die zugeordnete Vordergrundfarbe ist COLOR_MENUTEXT.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_MENUHILIGHT
29
 Die Farbe, die zum Hervorheben von Menüelementen verwendet wird, wenn das Menü als flaches Menü angezeigt wird (siehe SystemParametersInfo). Das hervorgehobene Menüelement ist mit COLOR_HIGHLIGHT umrissen.

Windows 2000, Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_MENUBAR
30
 Die Hintergrundfarbe für die Menüleiste, wenn Menüs als flache Menüs angezeigt werden (siehe SystemParametersInfo). COLOR_MENU geben jedoch weiterhin die Hintergrundfarbe des Menüpopups an.

Windows 2000, Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_MENUTEXT
7
 Text in Menüs. Die zugeordnete Hintergrundfarbe ist COLOR_MENU.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_SCROLLBAR
0
 Grauer Bereich der Bildlaufleiste.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_WINDOW
5
 Fensterhintergrund. Die zugeordneten Vordergrundfarben sind COLOR_WINDOWTEXT und COLOR_HOTLITE.
COLOR_WINDOWFRAME
6
 Fensterrahmen.

Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_WINDOWTEXT
8
 Text in Fenstern. Die zugeordnete Hintergrundfarbe ist COLOR_WINDOW.

Zurückgegebener Wert

Art: DWORD

Die Funktion gibt den Rot-, Grün-, Blau-(RGB)-Farbwert des angegebenen Elements zurück.

Wenn der nIndex-Parameter außerhalb des Bereichs liegt, ist der Rückgabewert null. Da null auch ein gültiger RGB-Wert ist, können Sie mit GetSysColor nicht ermitteln, ob eine Systemfarbe von der aktuellen Plattform unterstützt wird. Verwenden Sie stattdessen die GetSysColorBrush-Funktion , die NULL zurückgibt, wenn die Farbe nicht unterstützt wird.

Hinweise

Verwenden Sie zum Anzeigen der Komponente des RGB-Werts die Makros "GetRValue", "GetGValue" und "GetBValue ".

Systemfarben für monochrome Displays werden in der Regel als Grautöne interpretiert.

Um mit einem Systemfarbpinsel zu zeichnen, sollte GetSysColorBrush(nIndex)eine Anwendung anstelle von CreateSolidBrush(GetSysColor(nIndex)), da GetSysColorBrush einen zwischengespeicherten Pinsel zurückgibt, anstatt einen neuen zuzuweisen.

Farbe ist ein wichtiges visuelles Element der meisten Benutzeroberflächen. Richtlinien zur Verwendung von Farben in Ihren Anwendungen finden Sie unter "Farbe – Win32" und "Farbe" in Windows 11.

Windows 10/11 Systemfarben

Diese Tabelle zeigt die Werte, die in Windows 10 unterstützt werden, und Windows 11 mit Farbwerten aus dem Design "Windows 11 Aquatische Kontraste".

Farbmuster Description

COLOR_WINDOWHintergrund von Seiten, Bereichen, Popups und Fenstern.

Paar mit COLOR_WINDOWTEXT

COLOR_WINDOWTEXTÜberschriften, Textkörper, Listen, Platzhaltertext, App- und Fensterrahmen, jede Ui, mit der keine Interaktion möglich ist.

Paar mit COLOR_WINDOW

COLOR_HOTLIGHTLinks.

Paar mit COLOR_WINDOW

COLOR_GRAYTEXTInaktive (deaktivierte) Benutzeroberfläche.

Paar mit COLOR_WINDOW

COLOR_HIGHLIGHTTEXTVordergrundfarbe für Text oder Ui, der ausgewählt, interagiert mit (darauf zeigen, gedrückt) oder in Bearbeitung ist.

Koppeln mit COLOR_HIGHLIGHT

COLOR_HIGHLIGHTHintergrund- oder Akzentfarbe für die ausgewählte Benutzeroberfläche, interagiert mit (darauf zeigen, gedrückt) oder in Bearbeitung.

Paar mit COLOR_HIGHLIGHTTEXT

COLOR_BTNTEXTVordergrundfarbe für Schaltflächen und beliebige UI, mit denen interagiert werden kann.

Koppeln mit COLOR_3DFACE

COLOR_3DFACEHintergrundfarbe für Schaltflächen und beliebige UI, mit denen interagiert werden kann.

Koppeln mit COLOR_BTNTEXT

Diese Bilder zeigen, wie die Farben angezeigt werden, wenn sie auf einem Hintergrundsatz auf COLOR_WINDOW verwendet werden.

Beispiel Werte
Ein Fenster mit Text mithilfe der Fenstertextfarbe. COLOR_WINDOWTEXT
Ein Fenster mit Linktext mit der Farbe COLOR_HOTLIGHT
Ein Fenster mit inaktivem Text mit der grauen Textfarbe. COLOR_GRAYTEXT
Ein Fenster mit Text in der Textfarbe der Hervorhebung auf der Hervorhebungsfarbe. COLOR_HIGHLIGHTTEXT + HERVORHEBUNG
Ein Fenster mit einer Schaltfläche in der 3D-Flächenfarbe und einem Schaltflächentext in der Schaltflächentextfarbe. COLOR_BTNTEXT + COLOR_3DFACE

Beispiele

Ein Beispiel finden Sie unter SetSysColors.

Anforderungen

Anforderung Value
Mindestens unterstützter Client Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Header winuser.h (enthalten Windows.h)
Library User32.lib
DLL User32.dll

Siehe auch

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo-

  • Zuletzt aktualisiert um