Compartilhar via


CBitmap::CreateBitmap

Inicializa um bitmap de memória de dependente de dispositivo que tem largura, altura, e o padrão de bits especificados.

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

Parâmetros

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

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

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

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

  • lpBits
    Aponta para uma matriz de bytes que contém os valores iniciais de bits de bitmap. Se é NULO, o novo bitmap é deixado não inicializado.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Para um bitmap de cor, nPlanes ou o parâmetro de nBitcount devem ser definido como 1. Se ambos esses parâmetros são definidos como 1, CreateBitmap cria um bitmap monocromático.

Embora um bitmap diretamente não pode ser selecionado para um dispositivo de vídeo, pode ser selecionado como o projeto atual para “de um contexto de dispositivo” memória usando CDC::SelectObject e ser copiado para qualquer contexto correspondente de dispositivo usando a função de CDC::BitBlt .

Quando você terminar com o objeto de CBitmap criado pela função de CreateBitmap primeiro, selecione o projeto fora do contexto de dispositivo, então exclua o objeto de CBitmap .

Para obter mais informações, consulte a descrição do campo de bmBits na estrutura de BITMAP . A estrutura de BITMAP é descrita na função de membro de CBitmap::CreateBitmapIndirect .

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CBitmap

Gráfico da hierarquia

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap