Estrutura LOGBRUSH (wingdi.h)

A estrutura LOGBRUSH define o estilo, a cor e o padrão de um pincel físico. Ele é usado pelas funções CreateBrushIndirect e ExtCreatePen .

Sintaxe

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

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 Consulte 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 Consulte 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.

Requisitos

   
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)

Confira também

BITMAPINFO

Estruturas de pincel

Visão geral de pincéis

COLORREF

CreateBrushIndirect

Createdibsection

ExtCreatePen

LOGBRUSH32

RGB

Setbkcolor

Setbkmode