LOGBRUSH-Struktur (wingdi.h)

Artikel
08/27/2023

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)