Freigeben über


LOGBRUSH32 Struktur (wingdi.h)

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)

Weitere Informationen

BITMAPINFO

Pinselstrukturen

Übersicht über Pinsel

COLORREF

CreateDIBSection

EMRCREATEBRUSHINDIRECT

LOGBRUSH

RGB

SetBkColor

SetBkMode