CreateDIBPatternBrushPt-Funktion (wingdi.h)

Artikel
03/04/2024

Die CreateDIBPatternBrushPt-Funktion erstellt einen logischen Pinsel, der über das muster verfügt, das durch die geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) angegeben ist.

Syntax

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Parameter

[in] lpPackedDIB

Ein Zeiger auf einen gepackten DIB, der aus einer BITMAPINFO-Struktur besteht, unmittelbar gefolgt von einem Bytearray, das die Pixel der Bitmap definiert.

[in] iUsage

Gibt an, ob das bmiColors-Element der BITMAPINFO-Struktur eine gültige Farbtabelle enthält, und wenn ja, ob die Einträge in dieser Farbtabelle explizite rote, grüne, blaue (RGB)-Werte oder Palettenindizes enthalten. Der iUsage-Parameter muss einer der folgenden Werte sein.

Wert	Bedeutung
DIB_PAL_COLORS	Eine Farbtabelle wird bereitgestellt und besteht aus einem Array von 16-Bit-Indizes in der logischen Palette des Gerätekontexts, in dem der Pinsel ausgewählt werden soll.
DIB_RGB_COLORS	Es wird eine Farbtabelle bereitgestellt, die RGB-Literalwerte 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 das Innere gefüllter Formen zu malen.

Nachdem eine Anwendung einen Pinsel durch Aufrufen von CreateDIBPatternBrushPt erstellt hat, kann sie diesen Pinsel in jedem Gerätekontext auswählen, indem sie die SelectObject-Funktion aufruft .

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

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.

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