CBrush::CreateDIBPatternBrush

BOOL CreateDIBPatternBrushe( HGLOBAL hPackedDIB, UINT nUsado );

BOOL CreateDIBPatternBrushe ( const void * lpPackedDIB, UINT nUsado );

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário 0.

Parâmetros

hPackedDIB

Identifica um objeto memória global contendo um bitmap de independente de dispositivo (DIB) compactado.

nUsado

Especifica se os campos de bmiColors [] das BITMAPINFO estrutura de dados (uma parte do "embalada DIB") contêm explícito valores RGB ou índices para a paleta lógica realizada no momento. O parâmetro deve ser um dos seguintes valores:

• DIB_PAL_COLORS   Tabela de cores consiste de uma matriz de índices de 16 bits.
  
  
• DIB_RGB_COLORS   Tabela de cores contém valores literais RGB.

  O valor a seguir está disponível apenas na segunda versão desta função membro:

• DIB_PAL_I&NDICESnbsp;  Nenhuma tabela de cores é fornecida. O próprio bitmap contém índices para a paleta lógica do contexto de dispositivo no qual o pincel é a ser selecionado.

lpPackedDIB

Aponta para uma DIB compactada consiste em uma estrutura BITMAPINFO seguida imediatamente por uma matriz de bytes definindo os pixels do bitmap.

Observações

Inicializa um pincel com o padrão especificado por um bitmap independente de dispositivo (DIB). O pincel pode posteriormente ser selecionado para qualquer contexto de dispositivo que oferece suporte a operações de varredura.

As duas versões diferem na forma como você lida com o DIB:

• Na primeira versão, para obter um identificador para o DIB você chamar o Windows :: GlobalAlloc função para alocar um Bloquear de memória global e, em seguida, preencher a memória com o DIB compactada.
  
  
• In the segundo versão, não é necessário chamar :: GlobalAlloc para alocar memória para o DIB compactada.

Um DIB compactada consiste em uma estrutura de dados BITMAPINFO seguida imediatamente pela matriz de bytes que define os pixels do bitmap. Os bitmaps usados como padrões de preenchimento deve ser 8 pixels por 8 pixels. Se o bitmap for maior, o Windows cria um padrão de preenchimento usando somente os bits correspondente para as primeiro 8 linhas e 8 colunas de pixels no canto superior esquerdo do bitmap.

Quando um aplicativo seleciona um pincel de padrão DIB de duas cores em um contexto para dispositivo monocromática, Windows ignora as cores especificadas no DIB e em vez disso, exibe o pincel de padrão usando as cores de texto e plano de fundo atual do contexto de dispositivo. Pixels mapeados para a primeira cor (no deslocamento 0 na tabela de cores do DIB) do DIB são exibidos usando a cor do texto. Pixels mapeados para o segundo cor (em deslocamento 1 na tabela de cores) são exibidos usando a cor de fundo.

Para obter informações sobre como usar as seguintes funções do Windows, consulte o Referência do programador do Win32 SDK:

• :: CreateDIBPatternBrushenbsp;  (Essa função é fornecida somente para compatibilidade com aplicativos escritos para versões do Windows anteriores ao 3.0; use o :: CreateDIBPatternBrushPt função.)
  
  
• :: CreateDIBPatternBrushPtnbsp;  (Esta função deve ser usada para aplicativos baseados em Win32).
  
  
• :: GlobalAlloc

Visão geral de CBrush |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CBrush::CreatePatternBrush, CBrush::CreateBrushIndirect, CBrush::CreateSolidBrush, CBrush::CreateHatchBrush, CGdiObject::CreateStockObject, CDC:: SelectObject, CGdiObject:: DeleteObject, CDC::GetBrushOrg, CDC::SetBrushOrg