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 |