BOOL CreateBitmap ( int nWidth, int nHeight, UINT nPlanes, UINT nBitcount, const void * lpBits );
Valor de retorno
Diferente de zero se bem-sucedida; caso contrário 0.
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 cor no bitmap.
nBitcount
Especifica o número de bits de cor por pixel de exibir.
lpBits
Aponta para uma matriz de inteiro curto que contém os valores de bits de bitmap inicial. Se for NULL, o novo bitmap é esquerdo não inicializado.
Observações
Inicializa um bitmap de memória dependentes de dispositivo que tem a largura especificada, altura e padrão de bit.
Para um bitmap cor, o nPlanes ou nBitcount parâmetro deve ser definido como 1. Se ambos os parâmetros estiverem definidos como 1, CreateBitmap cria um bitmap monocromático.
Embora um bitmap não pode ser diretamente selecionado para um dispositivo de exibição, pode ser selecionado como o bitmap atual para um "contexto de dispositivo de memória" usando CDC:: SelectObject e copiado para qualquer contexto de dispositivo compatível usando o CDC:: BitBlt função.
Quando você concluir com o objeto CBitmap criado pela função CreateBitmap , primeiro selecionar o bitmap fora do contexto do dispositivo e excluir o objeto CBitmap.
Para obter mais informações, consulte a descrição do campo bmBits a estrutura de BITMAP . A estrutura BITMAP é descrita sob a função de membro CBitmap::CreateBitmapIndirect.
Visão geral de CBitmap | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC:: SelectObject, CGdiObject:: DeleteObject, CDC:: BitBlt, :: CreateBitmap