CreateSolidBrush-Funktion (wingdi.h)

Artikel
08/27/2023

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