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