CreatePatternBrush-Funktion (wingdi.h)
Die CreatePatternBrush-Funktion erstellt einen logischen Pinsel mit dem angegebenen Bitmapmuster. Die Bitmap kann eine DIB-Abschnittsbitmap sein, die von der CreateDIBSection-Funktion erstellt wird, oder es kann sich um eine geräteabhängige Bitmap handeln.
Syntax
HBRUSH CreatePatternBrush(
[in] HBITMAP hbm
);
Parameter
[in] hbm
Ein Handle für die Bitmap, die zum Erstellen des logischen Pinsels verwendet werden soll.
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
Ein Musterpinsel ist eine Bitmap, die das System verwendet, um die Innenausstattung gefüllter Formen zu malen.
Nachdem eine Anwendung einen Pinsel durch Aufrufen von CreatePatternBrush erstellt hat, kann sie diesen Pinsel in jedem Gerätekontext auswählen, indem sie die SelectObject-Funktion aufruft .
Sie können einen Musterpinsel löschen, ohne sich auf die zugeordnete Bitmap zu auswirken, indem Sie die DeleteObject-Funktion verwenden. Daher können Sie diese Bitmap verwenden, um eine beliebige Anzahl von Musterpinsel zu erstellen.
Ein Pinsel, der mit einer monochromen Bitmap (1 Bit pro Pixel) erstellt wird, weist die Text- und Hintergrundfarben des Gerätekontexts auf, auf den er gezeichnet wird. Pixel, die durch ein 0 Bit dargestellt werden, werden mit der aktuellen Textfarbe gezeichnet. Pixel, die durch ein 1-Bit dargestellt werden, werden mit der aktuellen Hintergrundfarbe gezeichnet.
ICM: Bei der Pinselerstellung erfolgt keine Farbe. 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 Verwenden von 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 |