GetSysColorBrush-Funktion (winuser.h)

Artikel
08/27/2023

Die GetSysColorBrush-Funktion ruft einen Handle ab, der einen logischen Pinsel identifiziert, der dem angegebenen Farbindex entspricht.

Syntax

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Parameter

[in] nIndex

Ein Farbindex. Dieser Wert entspricht der Farbe, die zum Zeichnen eines der Fensterelemente verwendet wird. Informationen zu Systemfarbindexwerten finden Sie unter GetSysColor .

Rückgabewert

Der Rückgabewert identifiziert einen logischen Pinsel, wenn der nIndex-Parameter von der aktuellen Plattform unterstützt wird. Andernfalls wird NULL zurückgegeben.

Hinweise

Ein Pinsel ist eine Bitmap, die das System verwendet, um die Innenräume gefüllter Formen zu malen. Eine Anwendung kann die aktuellen Systemfarben abrufen, indem sie die GetSysColor-Funktion aufruft. Eine Anwendung kann die aktuellen Systemfarben festlegen, indem sie die SetSysColors-Funktion aufruft .

Eine Anwendung darf keine Fensterklasse für ein Fenster mit einem Systempinsel registrieren. Informationen zum Registrieren einer Fensterklasse mit einer Systemfarbe finden Sie in der Dokumentation des hbrBackground-Members der WNDCLASS- oder WNDCLASSEX-Strukturen .

Systemfarbpinsel verfolgen Änderungen in Systemfarben nach. Anders ausgedrückt: Wenn der Benutzer eine Systemfarbe ändert, wird der zugehörige Systemfarbpinsel automatisch in die neue Farbe geändert.

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

Systemfarbenpinsel gehören dem System, sodass Sie sie nicht zerstören müssen. Obwohl Sie den logischen Pinsel, den GetSysColorBrush zurückgibt, nicht löschen müssen, tritt beim Aufrufen von DeleteObject kein Schaden auf.

Anforderungen

Anforderung	Wert
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
APIs	ext-ms-win-ntuser-gui-l1-1-1 (eingeführt in Windows 8.1)