CreatePatternBrush-Funktion (wingdi.h)

Artikel
03/06/2024

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