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