Compartilhar via


CBitmap::CreateCompatibleBitmap

Inicializa um bitmap que seja compatível com o dispositivo especificado por pDC.

BOOL CreateCompatibleBitmap( 
   CDC* pDC, 
   int nWidth, 
   int nHeight  
);

Parâmetros

  • pDC
    Especifica o contexto de dispositivo.

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

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

Valor de retorno

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

Comentários

O bitmap tem o mesmo número de planos de cor ou do mesmo formato de pixel bit-por- que o contexto específico de dispositivo. Pode ser selecionado como o projeto atual para qualquer dispositivo de armazenamento que seja compatível com aquele especificado por pDC.

Se pDC é um contexto do dispositivo de memória, bitmap retornado tem o mesmo formato que o bitmap atualmente selecionado em esse contexto de dispositivo. “De um contexto de dispositivo memória” é um bloco de memória que representa uma superfície de exibição. Pode ser usado para preparar imagens na memória antes da para a superfície de exibição copiar-las real de dispositivo correspondente.

Quando um contexto de dispositivo de memória é criado, GDI automaticamente seleciona um bitmap de stock monocromático para ele.

Desde que um contexto do dispositivo de memória de cor pode ter bitmaps de cores ou de monochrome selecionados, o formato de bitmap retornado pela função de CreateCompatibleBitmap não é sempre o mesmo; no entanto, o formato de um bitmap correspondente para um contexto nonmemory de dispositivo sempre está no formato de dispositivo.

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CBitmap

Gráfico da hierarquia

CreateCompatibleBitmap

CGdiObject::DeleteObject