Estructura LOGBRUSH (wingdi.h)

Artículo
08/27/2023

La estructura LOGBRUSH define el estilo, el color y el patrón de un pincel físico. Lo usan las funciones CreateBrushIndirect y ExtCreatePen .

Sintaxis

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

Miembros

lbStyle

Estilo de pincel. El miembro lbStyle debe ser uno de los estilos siguientes.

Value	Significado
BS_DIBPATTERN	Pincel de patrón definido por una especificación de mapa de bits (DIB) independiente del dispositivo. Si lbStyle es BS_DIBPATTERN, el miembro lbHatch contiene un identificador para un DIB empaquetado. Para obtener más información, vea discusión en lbHatch.
BS_DIBPATTERN8X8	Consulte BS_DIBPATTERN.
BS_DIBPATTERNPT	Pincel de patrón definido por una especificación de mapa de bits (DIB) independiente del dispositivo. Si lbStyle es BS_DIBPATTERNPT, el miembro lbHatch contiene un puntero a un DIB empaquetado. Para obtener más información, vea discusión en lbHatch.
BS_HATCHED	Pincel sombreado.
BS_HOLLOW	: pincel hueco.
BS_NULL	Igual que BS_HOLLOW.
BS_PATTERN	Pincel de patrón definido por un mapa de bits de memoria.
BS_PATTERN8X8	Consulte BS_PATTERN.
BS_SOLID	Pincel sólido.

lbColor

Color en el que se va a dibujar el pincel. Si lbStyle es el estilo BS_HOLLOW o BS_PATTERN, se omite lbColor .

Si lbStyle es BS_DIBPATTERN o BS_DIBPATTERNPT, la palabra de orden bajo de lbColor especifica si los miembros de ibColors de la estructura BITMAPINFO contienen valores o índices de color rojo, verde, azul (RGB) explícitos en la paleta lógica actualmente realizada. El miembro lbColor debe ser uno de los valores siguientes.

Value	Significado
DIB_PAL_COLORS	La tabla de colores consta de una matriz de índices de 16 bits en la paleta lógica realizada actualmente.
DIB_RGB_COLORS	La tabla de colores contiene valores RGB literales.

Si lbStyle es BS_HATCHED o BS_SOLID, lbColor es un valor de color COLORREF . Para crear un valor de color COLORREF , use la macro RGB .

lbHatch

Un estilo de sombreado. El significado depende del estilo de pincel definido por lbStyle.

Si lbStyle es BS_DIBPATTERN, el miembro lbHatch contiene un identificador para un DIB empaquetado. Para obtener este identificador, una aplicación llama a la función GlobalAlloc con GMEM_MOVEABLE (o LocalAlloc con LMEM_MOVEABLE) para asignar un bloque de memoria y, a continuación, rellena la memoria con la DIB empaquetada. Una DIB empaquetada consta de una estructura BITMAPINFO inmediatamente seguida de la matriz de bytes que definen los píxeles del mapa de bits.

Si lbStyle es BS_DIBPATTERNPT, el miembro lbHatch contiene un puntero a un DIB empaquetado. El puntero deriva del bloque de memoria creado por LocalAlloc con LMEM_FIXED establecido o por GlobalAlloc con GMEM_FIXED establecido, o es el puntero devuelto por una llamada como LocalLock (handle_to_the_dib). Una DIB empaquetada consta de una estructura BITMAPINFO inmediatamente seguida de la matriz de bytes que definen los píxeles del mapa de bits.

Si lbStyle es BS_HATCHED, el miembro lbHatch especifica la orientación de las líneas usadas para crear el sombreado. Puede ser uno de los siguientes valores.

Value	Significado
HS_BDIAGONAL	Un sombreado de 45 grados hacia arriba y de izquierda a derecha
HS_CROSS	Entrelazamiento horizontal y vertical
HS_DIAGCROSS	Bloqueo cruzado de 45 grados
HS_FDIAGONAL	Sombreado de izquierda a derecha de 45 grados hacia abajo
HS_HORIZONTAL	Sombreado horizontal
HS_VERTICAL	Sombreado vertical

Si lbStyle es BS_PATTERN, lbHatch es un identificador para el mapa de bits que define el patrón. El mapa de bits no puede ser un mapa de bits de sección DIB, creado por la función CreateDIBSection .

Si lbStyle es BS_SOLID o BS_HOLLOW, se omite lbHatch .

Comentarios

Aunque lbColor controla el color de primer plano de un pincel de sombreado, las funciones SetBkMode y SetBkColor controlan el color de fondo.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	wingdi.h (incluye Windows.h)