CreateBrushIndirect-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateBrushIndirect-Funktion erstellt einen logischen Pinsel mit dem angegebenen Stil, der angegebenen Farbe und dem angegebenen Muster.

Syntax

HBRUSH CreateBrushIndirect(
  [in] const LOGBRUSH *plbrush
);

Parameter

[in] plbrush

Ein Zeiger auf eine LOGBRUSH-Struktur , die Informationen zum Pinsel enthält.

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 Pinsel ist eine Bitmap, die das System verwendet, um die Innenräume gefüllter Formen zu malen.

Nachdem eine Anwendung einen Pinsel erstellt hat, indem sie CreateBrushIndirect aufruft, kann sie ihn in einem beliebigen Gerätekontext auswählen, indem sie die SelectObject-Funktion aufruft .

Ein Pinsel, der mit einer monochromen Bitmap (eine Farbebene, ein Bit pro Pixel) erstellt wird, wird mit den aktuellen Text- und Hintergrundfarben gezeichnet. Pixel, die durch ein auf 0 festgelegtes Bit dargestellt werden, werden mit der aktuellen Textfarbe gezeichnet. Pixel, die durch ein auf 1 festgelegtes Bit dargestellt werden, werden mit der aktuellen Hintergrundfarbe gezeichnet.

Wenn Sie den Pinsel nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um ihn zu löschen.

ICM: Beim Erstellen des Pinsels erfolgt keine Farbe. Die Farbverwaltung wird jedoch ausgeführt, wenn der Pinsel in einen ICM-fähigen Gerätekontext ausgewählt wird.

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll