estructura LOGBRUSH32 (wingdi.h)

Artículo
03/08/2023

La estructura LOGBRUSH32 define el estilo, el color y el patrón de un pincel físico. Es similar a LOGBRUSH, pero se usa para mantener la compatibilidad entre plataformas de 32 bits y plataformas de 64 bits cuando grabamos el registro de metarchivo en una plataforma y luego lo reproducimos en otra. Por lo tanto, solo se utiliza en EMRCREATEBRUSHINDIRECT. Si el código solo estará en una plataforma, LOGBRUSH es suficiente.

Sintaxis

typedef struct tagLOGBRUSH32 {
  UINT     lbStyle;
  COLORREF lbColor;
  ULONG    lbHatch;
} LOGBRUSH32, *PLOGBRUSH32, *NPLOGBRUSH32, *LPLOGBRUSH32;

Miembros

lbStyle

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

Valor	Significado
BS_DIBPATTERN	Pincel de patrón definido por una especificación de mapa de bits independiente del dispositivo (DIB). 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	Igual que BS_DIBPATTERN.
BS_DIBPATTERNPT	Pincel de patrón definido por una especificación de mapa de bits independiente del dispositivo (DIB). 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	Igual que 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 explícitos rojo, verde, azul (RGB) o índices en la paleta lógica realizada actualmente. El miembro lbColor debe ser uno de los valores siguientes.

Valor	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

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 seguida inmediatamente 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 seguida inmediatamente 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 utilizadas para crear el sombreado. Puede ser uno de los siguientes valores.

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

Si lbStyle es BS_PATTERN, lbHatch es un controlador 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, lbHatch se omite.

Comentarios

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

Los pinceles se pueden crear a partir de mapas de bits o DIB de más de 8 por 8 píxeles.

Requisitos

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