CreateDIBPatternBrush-Funktion (wingdi.h)

Artikel
03/13/2024

Die CreateDIBPatternBrush-Funktion erstellt einen logischen Pinsel, der das durch die angegebene geräteunabhängige Bitmap (DEVICE-Independent Bitmap, DIB) angegebene Muster aufweist. Der Pinsel kann anschließend in jedem Gerätekontext ausgewählt werden, der einem Gerät zugeordnet ist, das Rastervorgänge unterstützt.

Hinweis Diese Funktion wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die CreateDIBPatternBrushPt-Funktion verwenden.

Syntax

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Parameter

[in] h

Ein Handle für ein globales Speicherobjekt, das einen gepackten DIB enthält, das aus einer BITMAPINFO-Struktur besteht, die unmittelbar von einem Bytearray folgt, das die Pixel der Bitmap definiert.

[in] iUsage

Gibt an, ob das bmiColors-Element der BITMAPINFO-Struktur initialisiert wird und ob dieses Element explizite rote, grüne, blaue (RGB)-Werte oder Indizes in einer logischen Palette enthält. Der fuColorSpec-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

Wenn eine Anwendung einen zweifarbigen DIB-Musterpinsel in einen monochromen Gerätekontext auswählt, erkennt das System die im DIB angegebenen Farben nicht an. stattdessen wird der Musterpinsel mit den aktuellen Hintergrund- und Vordergrundfarben des Gerätekontexts angezeigt. Pixel, die der ersten Farbe des DIB (Offset 0 in der DIB-Farbtabelle) zugeordnet sind, werden mithilfe der Vordergrundfarbe angezeigt. Pixel, die der zweiten Farbe (Offset 1 in der Farbtabelle) zugeordnet sind, werden mithilfe der Hintergrundfarbe angezeigt.

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