Função CreateDIBPatternBrushPt (wingdi.h)

Artigo
03/04/2024

A função CreateDIBPatternBrushPt cria um pincel lógico que tem o padrão especificado pelo DIB (bitmap independente do dispositivo).

Sintaxe

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Parâmetros

[in] lpPackedDIB

Um ponteiro para 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 contém uma tabela de cores válida e, nesse caso, se as entradas nessa tabela de cores contêm valores explícitos de vermelho, verde, azul (RGB) ou índices de paleta. O parâmetro iUsage deve ser um dos valores a seguir.

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

Um pincel é um bitmap que o sistema usa para pintar os interiores das formas preenchidas.

Depois que um aplicativo cria um pincel chamando CreateDIBPatternBrushPt, ele pode selecionar esse pincel em qualquer contexto de dispositivo chamando a função SelectObject .

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