Compartilhar via


Função CreateDIBPatternBrushPt (wingdi.h)

A função CreateDIBPatternBrushPt cria um pincel lógico que tem o padrão especificado pelo DIB (bitmap independente do dispositivo).

Sintaxe

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Parâmetros

[in] lpPackedDIB

Um ponteiro para 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 contém uma tabela de cores válida e, nesse caso, se as entradas nessa tabela de cores contêm valores explícitos de vermelho, verde, azul (RGB) ou índices de paleta. O parâmetro iUsage deve ser um dos valores a seguir.

Valor Significado
DIB_PAL_COLORS
Uma tabela de cores é fornecida e consiste em uma matriz de índices de 16 bits na paleta lógica do contexto do dispositivo no qual o pincel deve ser selecionado.
DIB_RGB_COLORS
Uma tabela de cores é fornecida e contém valores RGB literais.

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

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

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

Confira também

BITMAPINFO

Funções brush

Visão geral de pincéis

CreateDIBPatternBrush

Createhatchbrush

Createpatternbrush

Createsolidbrush

DeleteObject

GetBrushOrgEx

Selectobject

Setbrushorgex