Função CreateBrushIndirect (wingdi.h)

Artigo
03/04/2024

A função CreateBrushIndirect cria um pincel lógico que tem o estilo, a cor e o padrão especificados.

Sintaxe

HBRUSH CreateBrushIndirect(
  [in] const LOGBRUSH *plbrush
);

Parâmetros

[in] plbrush

Um ponteiro para uma estrutura LOGBRUSH que contém informações sobre o pincel.

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 de formas preenchidas.

Depois que um aplicativo cria um pincel chamando CreateBrushIndirect, ele pode selecioná-lo em qualquer contexto de dispositivo chamando a função SelectObject .

Um pincel criado usando um bitmap monocromático (um plano de cores, um bit por pixel) é desenhado usando o texto atual e as cores da tela de fundo. Os pixels representados por um bit definido como 0 são desenhados com a cor do texto atual; pixels representados por um bit definido como 1 são desenhados com a cor da tela de fundo atual.

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