Função CreatePatternBrush (wingdi.h)

Artigo
03/13/2024

A função CreatePatternBrush cria um pincel lógico com o padrão de bitmap especificado. O bitmap pode ser um bitmap de seção DIB, que é criado pela função CreateDIBSection ou pode ser um bitmap dependente do dispositivo.

Sintaxe

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Parâmetros

[in] hbm

Um identificador para o bitmap a ser usado para criar o pincel lógico.

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 de padrão é um bitmap que o sistema usa para pintar os interiores das formas preenchidas.

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

Você pode excluir um pincel de padrão sem afetar o bitmap associado usando a função DeleteObject . Portanto, você pode usar esse bitmap para criar qualquer número de pincéis padrão.

Um pincel criado usando um bitmap monocromático (1 bit por pixel) tem o texto e as cores da tela de fundo do contexto do dispositivo ao qual ele é desenhado. Pixels representados por um 0 bit são desenhados com a cor do texto atual; pixels representados por um 1 bit são desenhados com a cor da tela de fundo atual.

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.

Exemplos

Para obter um exemplo, consulte Usando pincéis.

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