CBitmap:: CreateBitmap

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 CBitmapMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC:: SelectObject, CGdiObject:: DeleteObject, CDC:: BitBlt, :: CreateBitmap

Index