LOGBRUSH-Struktur (wingdi.h)

Die LOGBRUSH-Struktur definiert den Stil, die Farbe und das Muster eines physischen Pinsels. Sie wird von den Funktionen CreateBrushIndirect und ExtCreatePen verwendet.

Syntax

typedef struct tagLOGBRUSH {
  UINT      lbStyle;
  COLORREF  lbColor;
  ULONG_PTR lbHatch;
} LOGBRUSH, *PLOGBRUSH, *NPLOGBRUSH, *LPLOGBRUSH;

Member

lbStyle

Der Pinselstil. Das lbStyle-Element muss eine der folgenden Formatvorlagen sein.

Wert Bedeutung
BS_DIBPATTERN Ein Musterpinsel, der durch eine DIB-Spezifikation (Device-Independent Bitmap) definiert wird. Wenn lbStyle BS_DIBPATTERN ist, enthält das lbHatch-Element einen Handle für einen gepackten DIB. Weitere Informationen finden Sie unter Diskussion in lbHatch.
BS_DIBPATTERN8X8 Siehe BS_DIBPATTERN.
BS_DIBPATTERNPT Ein Musterpinsel, der durch eine DIB-Spezifikation (Device-Independent Bitmap) 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 Speicherbitbitte definiert wird.
BS_PATTERN8X8 Siehe BS_PATTERN.
BS_SOLID Einfarbiger Pinsel.

lbColor

Die Farbe, in der der Pinsel gezeichnet werden soll. Wenn lbStyle die BS_HOLLOW oder BS_PATTERN Formatvorlage ist, wird lbColor ignoriert.

Wenn lbStyle BS_DIBPATTERN oder BS_DIBPATTERNPT ist, gibt das Wort mit niedriger Ordnung von lbColor an, ob die bmiColors-Member der BITMAPINFO-Struktur explizite rote, grüne, blaue (RGB)-Werte oder Indizes in der derzeit realisierten logischen Palette enthalten. Der lbColor-Member 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 . Verwenden Sie das RGB-Makro, um einen COLORREF-Farbwert zu erstellen.

lbHatch

Ein Schraffurstil. Die Bedeutung hängt vom von lbStyle definierten Pinselstil ab.

Wenn lbStyle BS_DIBPATTERN ist, enthält das lbHatch-Element einen Handle für einen gepackten DIB. Um dieses Handle zu erhalten, 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 auf. 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 wird vom Speicherblock abgeleitet, der von LocalAlloc mit LMEM_FIXED oder von GlobalAlloc mit GMEM_FIXED festgelegt 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 der lbHatch-Member die Ausrichtung der Linien an, die zum Erstellen der Schraffur 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 Querschlüske
HS_DIAGCROSS 45-Grad-Kreuzhatch
HS_FDIAGONAL Eine 45 Grad nach unten, von links nach rechts Schraffur
HS_HORIZONTAL Horizontale Schraffur
HS_VERTICAL Vertikale Schraffur
 

Wenn lbStyle BS_PATTERN ist, ist lbHatch ein Handle für die Bitmap, die das Muster definiert. Die Bitmap darf 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.

Anforderungen

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

Weitere Informationen

BITMAPINFO

Pinselstrukturen

Übersicht über Pinsel

COLORREF

CreateBrushIndirect

CreateDIBSection

ExtCreatePen

LOGBRUSH32

RGB

SetBkColor

SetBkMode