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) |