Função CreateDIBPatternBrush (wingdi.h)

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.

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.

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

Confira também

BITMAPINFO

Funções brush

Visão geral de pincéis

Createdibpatternbrushpt

Createhatchbrush

Createpatternbrush

Createsolidbrush

DeleteObject

Setbkcolor

Settextcolor