GetSysColor-Funktion (winuser.h)

Artikel
08/27/2023

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

Syntax

DWORD GetSysColor(
  [in] int nIndex
);

Parameter

[in] nIndex

Typ: int

Das Anzeigeelement, dessen Farbe abgerufen werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	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	Farbe für dreidimensionale Anzeigeelemente hervorheben (für Kanten, die der Lichtquelle zugewandt sind).) Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DHILIGHT 20	Farbe für dreidimensionale Anzeigeelemente hervorheben (für Kanten, die der Lichtquelle zugewandt sind).) Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DLIGHT 22	Lichtfarbe für dreidimensionale Anzeigeelemente (für Ränder, die der Lichtquelle zugewandt sind).) Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_3DSHADOW 16	Schattenfarbe für dreidimensionale Anzeigeelemente (für Von der Lichtquelle abgewandte Kanten). 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 zugehörige 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 von MDI-Anwendungen (Multiple 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	Farbe für dreidimensionale Anzeigeelemente hervorheben (für Kanten, die der Lichtquelle zugewandt sind).) Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNHILIGHT 20	Farbe für dreidimensionale Anzeigeelemente hervorheben (für Kanten, die der Lichtquelle zugewandt sind).) Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNSHADOW 16	Schattenfarbe für dreidimensionale Anzeigeelemente (für Von der Lichtquelle abgewandte Kanten). Windows 10 oder höher: Dieser Wert wird nicht unterstützt.
COLOR_BTNTEXT 18	Text auf Drucktasten. Die zugehörige Hintergrundfarbe ist COLOR_BTNFACE.
COLOR_CAPTIONTEXT 9	Text in Untertitel, Größenfeld und Pfeilfeld der Bildlaufleiste. 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	Abgeblendeter (deaktivierter) Text. Diese Farbe wird auf 0 festgelegt, wenn der aktuelle Anzeigetreiber keine einfarbige graue Farbe 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 einen Link oder ein 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	Inaktives Fenster Untertitel. 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	Textfarbe in einer inaktiven Untertitel. 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 wird mit COLOR_HIGHLIGHT. 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 gibt 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.

Rückgabewert

Art: DWORD

Die Funktion gibt den Farbwert rot, grün, blau (RGB) des angegebenen Elements zurück.

Wenn sich der nIndex-Parameter außerhalb des Bereichs befindet, ist der Rückgabewert null. Da null auch ein gültiger RGB-Wert ist, können Sie getSysColor nicht verwenden, um zu bestimmen, 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 Anzeigen werden in der Regel als Grautöne interpretiert.

Um mit einem Systemfarbpinsel zu zeichnen, sollte eine Anwendung anstelle von CreateSolidBrush(GetSysColor(nIndex))verwendenGetSysColorBrush(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.

systemfarben Windows 10/11

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

Farbfeld	BESCHREIBUNG
	COLOR_WINDOWHintergrund von Seiten, Bereichen, Popups und Fenstern. Koppeln mit COLOR_WINDOWTEXT
	COLOR_WINDOWTEXTÜberschriften, Textkörperkopien, Listen, Platzhaltertext, App- und Fensterrahmen, alle Ui-Elemente, mit denen nicht interagiert werden kann. Koppeln mit COLOR_WINDOW
	COLOR_HOTLIGHTHyperlinks. Koppeln mit COLOR_WINDOW
	COLOR_GRAYTEXTInaktive (deaktivierte) Benutzeroberfläche. Koppeln mit COLOR_WINDOW
	COLOR_HIGHLIGHTTEXTVordergrundfarbe für Text oder Benutzeroberfläche, der ausgewählt ist, mit dem sie interagiert (mit dem Mauszeiger, gedrückt) oder in Bearbeitung ist. Koppeln mit COLOR_HIGHLIGHT
	COLOR_HIGHLIGHTHintergrund- oder Akzentfarbe für die Benutzeroberfläche, die ausgewählt ist, mit der interagiert (mit dem Mauszeiger, gedrückt) oder in Bearbeitung ist. Koppeln mit COLOR_HIGHLIGHTTEXT
	COLOR_BTNTEXTVordergrundfarbe für Schaltflächen und beliebige Ui-Elemente, mit denen interagiert werden kann. Koppeln mit COLOR_3DFACE
	COLOR_3DFACEHintergrundfarbe für Schaltflächen und benutzeroberfläche, mit der interagiert werden kann. Koppeln mit COLOR_BTNTEXT

Diese Bilder zeigen, wie die Farben angezeigt werden, wenn sie auf einem Hintergrund verwendet werden , der auf COLOR_WINDOW festgelegt ist.

Beispiel	Werte
	COLOR_WINDOWTEXT
	COLOR_HOTLIGHT
	COLOR_GRAYTEXT
	COLOR_HIGHLIGHTTEXT + HIGHLIGHT
	COLOR_BTNTEXT + COLOR_3DFACE

Beispiele

Ein Beispiel finden Sie unter SetSysColors.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll