CreateSolidBrush-Funktion (wingdi.h)
Die CreateSolidBrush-Funktion erstellt einen logischen Pinsel mit der angegebenen Volltonfarbe.
Syntax
HBRUSH CreateSolidBrush(
[in] COLORREF color
);
Parameter
[in] color
Die Farbe des Pinsels. Verwenden Sie das RGB-Makro, um einen COLORREF-Farbwert zu erstellen.
Rückgabewert
Wenn die Funktion erfolgreich ist, identifiziert der Rückgabewert einen logischen Pinsel.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Hinweise
Wenn Sie das HBRUSH-Objekt nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um es zu löschen.
Ein vollfarbiger Pinsel ist eine Bitmap, die das System verwendet, um das Innere gefüllter Formen zu malen.
Nachdem eine Anwendung einen Pinsel durch Aufrufen von CreateSolidBrush erstellt hat, kann sie diesen Pinsel in jedem Gerätekontext auswählen, indem sie die SelectObject-Funktion aufruft .
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.
ICM: Bei der Pinselerstellung wird keine Farbverwaltung durchgeführt. Die Farbverwaltung wird jedoch ausgeführt, wenn der Pinsel in einen ICM-fähigen Gerätekontext ausgewählt wird.
Beispiele
Ein Beispiel finden Sie unter Erstellen farbiger Stifte und Pinsel.
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 | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |