Função CreateDIBPatternBrush (wingdi.h)

Artigo
03/13/2024

A função CreateDIBPatternBrush cria um pincel lógico que tem o padrão especificado pelo DIB (bitmap independente do dispositivo) especificado. Posteriormente, o pincel pode ser selecionado em qualquer contexto de dispositivo associado a um dispositivo que dê suporte a operações de raster.

Nota Essa função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função CreateDIBPatternBrushPt .

Sintaxe

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Parâmetros

[in] h

Um identificador para um objeto de memória global que contém um DIB empacotado, que consiste em uma estrutura BITMAPINFO imediatamente seguida por uma matriz de bytes que define os pixels do bitmap.

[in] iUsage

Especifica se o membro bmiColors da estrutura BITMAPINFO é inicializado e, nesse caso, se esse membro contém valores ou índices vermelhos explícitos, verdes, azuis (RGB) em uma paleta lógica. O parâmetro fuColorSpec deve ser um dos seguintes valores.

Valor	Significado
DIB_PAL_COLORS	Uma tabela de cores é fornecida e consiste em uma matriz de índices de 16 bits na paleta lógica do contexto do dispositivo no qual o pincel deve ser selecionado.
DIB_RGB_COLORS	Uma tabela de cores é fornecida e contém valores RGB literais.

Retornar valor

Se a função for bem-sucedida, o valor retornado identificará um pincel lógico.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando um aplicativo seleciona um pincel de padrão DIB de duas cores em um contexto de dispositivo monocromático, o sistema não reconhece as cores especificadas no DIB; Em vez disso, ele exibe o pincel de padrão usando as cores de plano de fundo e de primeiro plano atuais do contexto do dispositivo. Os pixels mapeados para a primeira cor do DIB (deslocamento 0 na tabela de cores DIB) são exibidos usando a cor de primeiro plano; pixels mapeados para a segunda cor (deslocamento 1 na tabela de cores) são exibidos usando a cor da tela de fundo.

Quando você não precisar mais do pincel, chame a função DeleteObject para excluí-la.

ICM: Nenhuma cor é feita na criação do pincel. No entanto, o gerenciamento de cores é executado quando o pincel é selecionado em um contexto de dispositivo habilitado para ICM.

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]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll