Freigeben über


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

Weitere Informationen

Pinselfunktionen

Übersicht über Pinsel

COLORREF

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateHatchBrush

CreatePatternBrush

DeleteObject

GetSysColorBrush

RGB

Auswählenobjekt