Compartilhar via


Função CreatePatternBrush (wingdi.h)

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

Confira também

Funções brush

Visão geral de pincéis

Createbitmap

Createbitmapindirect

Createcompatiblebitmap

CreateDIBPatternBrush

Createdibpatternbrushpt

Createdibsection

Createhatchbrush

DeleteObject

GetBrushOrgEx

Loadbitmap

Selectobject

Setbrushorgex