Freigeben über


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

Weitere Informationen

Pinselfunktionen

Übersicht über Pinsel

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

Auswählenobjekt

SetBrushOrgEx