estrutura LOGBRUSH32 (wingdi.h)

Artigo
03/13/2024

A estrutura LOGBRUSH32 define o estilo, a cor e o padrão de um pincel físico. Ele é semelhante a LOGBRUSH, mas é usado para manter a compatibilidade entre plataformas de 32 bits e plataformas de 64 bits quando gravamos o registro de metafile em uma plataforma e reproduzimos em outra. Portanto, ele só é usado em EMRCREATEBRUSHINDIRECT. Se o código estiver apenas em uma plataforma, LOGBRUSH será suficiente.

Sintaxe

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

Membros

lbStyle

O estilo de pincel. O membro lbStyle deve ser um dos estilos a seguir.

Valor	Significado
BS_DIBPATTERN	Um pincel de padrão definido por uma especificação DIB (bitmap independente do dispositivo). Se lbStyle for BS_DIBPATTERN, o membro lbHatch conterá um identificador para um DIB empacotado. Para obter mais informações, consulte discussão em lbHatch.
BS_DIBPATTERN8X8	O mesmo que BS_DIBPATTERN.
BS_DIBPATTERNPT	Um pincel de padrão definido por uma especificação DIB (bitmap independente do dispositivo). Se lbStyle for BS_DIBPATTERNPT, o membro lbHatch conterá um ponteiro para um DIB empacotado. Para obter mais informações, consulte discussão em lbHatch.
BS_HATCHED	Pincel de escotilhado.
BS_HOLLOW	Pincel vazado.
BS_NULL	O mesmo que BS_HOLLOW.
BS_PATTERN	Pincel de padrão definido por um bitmap de memória.
BS_PATTERN8X8	O mesmo que BS_PATTERN.
BS_SOLID	Pincel sólido.

lbColor

A cor na qual o pincel deve ser desenhado. Se lbStyle for o estilo BS_HOLLOW ou BS_PATTERN, lbColor será ignorado.

Se lbStyle for BS_DIBPATTERN ou BS_DIBPATTERNPT, a palavra de baixa ordem lbColor especifica se os membros bmiColors da estrutura BITMAPINFO contêm valores ou índices vermelhos explícitos, verdes, azuis (RGB) na paleta lógica atualmente realizada. O membro lbColor deve ser um dos valores a seguir.

Valor	Significado
DIB_PAL_COLORS	A tabela de cores consiste em uma matriz de índices de 16 bits na paleta lógica atualmente realizada.
DIB_RGB_COLORS	A tabela de cores contém valores RGB literais.

Se lbStyle for BS_HATCHED ou BS_SOLID, lbColor será um valor de cor COLORREF . Para criar um valor de cor COLORREF , use a macro RGB .

lbHatch

Um estilo hatch. O significado depende do estilo de pincel definido por lbStyle.

Se lbStyle for BS_DIBPATTERN, o membro lbHatch conterá um identificador para um DIB empacotado. Para obter esse identificador, um aplicativo chama a função GlobalAlloc com GMEM_MOVEABLE (ou LocalAlloc com LMEM_MOVEABLE) para alocar um bloco de memória e preenche a memória com o DIB empacotado. Um DIB empacotado consiste em uma estrutura BITMAPINFO imediatamente seguida pela matriz de bytes que definem os pixels do bitmap.

Se lbStyle for BS_DIBPATTERNPT, o membro lbHatch conterá um ponteiro para um DIB empacotado. O ponteiro deriva do bloco de memória criado por LocalAlloc com LMEM_FIXED definido ou por GlobalAlloc com GMEM_FIXED definido ou é o ponteiro retornado por uma chamada como LocalLock (handle_to_the_dib). Um DIB empacotado consiste em uma estrutura BITMAPINFO imediatamente seguida pela matriz de bytes que definem os pixels do bitmap.

Se lbStyle for BS_HATCHED, o membro lbHatch especificará a orientação das linhas usadas para criar o hatch. Pode ser um dos seguintes valores.

Valor	Significado
HS_BDIAGONAL	Uma escotilha 45 graus para cima, da esquerda para a direita
HS_CROSS	Escotilha cruzada horizontal e vertical
HS_DIAGCROSS	Trava cruzada de 45 graus
HS_FDIAGONAL	Uma escotilha de 45 graus para baixo, da esquerda para a direita
HS_HORIZONTAL	Hachura horizontal
HS_VERTICAL	Hachura vertical

Se lbStyle for BS_PATTERN, lbHatch será um identificador para o bitmap que define o padrão. O bitmap não pode ser um bitmap de seção DIB, que é criado pela função CreateDIBSection .

Se lbStyle for BS_SOLID ou BS_HOLLOW, lbHatch será ignorado.

Comentários

Embora lbColor controle a cor de primeiro plano de um pincel de hatch, as funções SetBkMode e SetBkColor controlam a cor da tela de fundo.

Pincéis podem ser criados a partir de bitmaps ou DIBs maiores que 8 por 8 pixels.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	wingdi.h (inclua Windows.h)