LOGBRUSH32 Struktur (wingdi.h)

Artikel
03/04/2024

Die LOGBRUSH32-Struktur definiert den Stil, die Farbe und das Muster eines physischen Pinsels. Es ähnelt LOGBRUSH, wird jedoch verwendet, um die Kompatibilität zwischen 32-Bit-Plattformen und 64-Bit-Plattformen zu gewährleisten, wenn wir den Metadateidatensatz auf einer Plattform aufzeichnen und ihn dann auf einer anderen plattform wiedergeben. Daher wird es nur in EMRCREATEBRUSHINDIRECT verwendet. Wenn sich der Code nur auf einer Plattform befindet, ist LOGBRUSH ausreichend.

Syntax

typedef struct tagLOGBRUSH32 {
  UINT     lbStyle;
  COLORREF lbColor;
  ULONG    lbHatch;
} LOGBRUSH32, *PLOGBRUSH32, *NPLOGBRUSH32, *LPLOGBRUSH32;

Member

lbStyle

Der Pinselstil. Das lbStyle-Element muss einer der folgenden Stile sein.

Wert	Bedeutung
BS_DIBPATTERN	Ein Musterpinsel, der durch eine geräteunabhängige Bitmap-Spezifikation (DIB) definiert wird. Wenn lbStyle BS_DIBPATTERN ist, enthält das lbHatch-Element einen Handle zu einem gepackten DIB. Weitere Informationen finden Sie unter Diskussion in lbHatch.
BS_DIBPATTERN8X8	Identisch mit BS_DIBPATTERN.
BS_DIBPATTERNPT	Ein Musterpinsel, der durch eine geräteunabhängige Bitmap-Spezifikation (DIB) definiert wird. Wenn lbStyle BS_DIBPATTERNPT ist, enthält das lbHatch-Element einen Zeiger auf einen gepackten DIB. Weitere Informationen finden Sie unter Diskussion in lbHatch.
BS_HATCHED	Geschlüpfter Pinsel.
BS_HOLLOW	Hohlpinsel.
BS_NULL	Identisch mit BS_HOLLOW.
BS_PATTERN	Musterpinsel, der durch eine Speicher-Bitmap definiert wird.
BS_PATTERN8X8	Identisch mit BS_PATTERN.
BS_SOLID	Einfarbiger Pinsel.

lbColor

Die Farbe, in der der Pinsel gezeichnet werden soll. Wenn lbStyle das BS_HOLLOW- oder BS_PATTERN-Format ist, wird lbColor ignoriert.

Wenn lbStyle BS_DIBPATTERN oder BS_DIBPATTERNPT ist, gibt das Wort mit niedriger Reihenfolge von lbColor an, ob die bmiColors-Member der BITMAPINFO-Struktur explizite rote, grüne, blaue (RGB)-Werte oder Indizes in der aktuell realisierten logischen Palette enthalten. Das lbColor-Element muss einer der folgenden Werte sein.

Wert	Bedeutung
DIB_PAL_COLORS	Die Farbtabelle besteht aus einem Array von 16-Bit-Indizes in der derzeit realisierten logischen Palette.
DIB_RGB_COLORS	Die Farbtabelle enthält RGB-Literalwerte.

Wenn lbStyle BS_HATCHED oder BS_SOLID ist, ist lbColor ein COLORREF-Farbwert . Um einen COLORREF-Farbwert zu erstellen, verwenden Sie das RGB-Makro .

lbHatch

Ein Schraffurstil. Die Bedeutung hängt von der von lbStyle definierten Pinselart ab.

Wenn lbStyle BS_DIBPATTERN ist, enthält das lbHatch-Element einen Handle zu einem gepackten DIB. Um dieses Handle abzurufen, ruft eine Anwendung die GlobalAlloc-Funktion mit GMEM_MOVEABLE (oder LocalAlloc mit LMEM_MOVEABLE) auf, um einen Speicherblock zuzuweisen, und füllt den Speicher dann mit dem gepackten DIB. Ein gepackter DIB besteht aus einer BITMAPINFO-Struktur unmittelbar gefolgt von dem Bytearray, das die Pixel der Bitmap definiert.

Wenn lbStyle BS_DIBPATTERNPT ist, enthält das lbHatch-Element einen Zeiger auf einen gepackten DIB. Der Zeiger leitet sich von dem Speicherblock ab, der von LocalAlloc mit LMEM_FIXED oder von GlobalAlloc mit GMEM_FIXED Satz erstellt wurde, oder es handelt sich um den Zeiger, der von einem Aufruf wie LocalLock (handle_to_the_dib) zurückgegeben wird. Ein gepackter DIB besteht aus einer BITMAPINFO-Struktur unmittelbar gefolgt von dem Bytearray, das die Pixel der Bitmap definiert.

Wenn lbStyle BS_HATCHED ist, gibt das lbHatch-Element die Ausrichtung der Linien an, die zum Erstellen der Luke verwendet werden. Dieses Argument einen der folgenden Werte annehmen.

Wert	Bedeutung
HS_BDIAGONAL	Eine 45-Grad-Aufwärtsluke, von links nach rechts
HS_CROSS	Horizontale und vertikale Kreuzluke
HS_DIAGCROSS	45-Grad-Kreuzhatch
HS_FDIAGONAL	Eine 45-Grad-Nach unten, von links nach rechts Luke
HS_HORIZONTAL	Horizontale Luke
HS_VERTICAL	Vertikale Luke

Wenn lbStyle BS_PATTERN ist, ist lbHatch ein Handle für die Bitmap, die das Muster definiert. Die Bitmap kann keine DIB-Abschnittsbit sein, die von der CreateDIBSection-Funktion erstellt wird.

Wenn lbStyle BS_SOLID oder BS_HOLLOW ist, wird lbHatch ignoriert.

Hinweise

Obwohl lbColor die Vordergrundfarbe eines Schraffurpinsels steuert, steuern die Funktionen SetBkMode und SetBkColor die Hintergrundfarbe.

Pinsel können aus Bitmaps oder DIBs erstellt werden, die größer als 8 x 8 Pixel sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h (einschließlich Windows.h)