Partilhar via


CBitmap::CreateBitmap

Inicializa um bitmap dependente do dispositivo de memória que tenha a largura especificada, altura e padrão de bit.

BOOL CreateBitmap(
   int nWidth,
   int nHeight,
   UINT nPlanes,
   UINT nBitcount,
   const void* lpBits 
);

Parâmetros

  • nWidth
    Especifica a largura (em pixels) do bitmap.

  • nHeight
    Especifica a altura (em pixels) do bitmap.

  • nPlanes
    Especifica o número de planos de cores no bitmap.

  • nBitcount
    Especifica o número de bits de cores por pixel de exibição.

  • lpBits
    Aponta para uma matriz de inteiro curto que contém os valores de bit inicial de bitmap.Se for NULO, o novo bitmap é deixado não inicializado.

Valor de retorno

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

Comentários

Para um bitmap de cor, ambos o nPlanes ou nBitcount o parâmetro deve ser conjunto como 1. Se ambos os parâmetros forem conjunto como 1, CreateBitmap cria um bitmap monocromático.

Embora um bitmap não pode ser selecionado diretamente para um dispositivo de vídeo, pode ser selecionado sistema autônomo o bitmap corrente para um "contexto de dispositivo de memória", usandoCDC::SelectObject contexto de dispositivo copiada para qualquer compatível usando o e CDC::BitBlt função.

Quando você termina com o CBitmap objeto criado pela CreateBitmap funcionar, primeiro selecionar o bitmap para fora do contexto de dispositivo e, em seguida, excluir o CBitmap objeto.

Para obter mais informações, consulte a descrição do bmBits campo o BITMAP estrutura.The BITMAP estrutura é descrita no CBitmap::CreateBitmapIndirectfunção de membro .

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CBitmap

Gráfico de hierarquia

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap

Outros recursos

CBitmap membros