Partilhar via


CBitmap::CreateCompatibleBitmap

Inicializa um bitmap 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) do bitmap.

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

Valor de retorno

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

Comentários

O bitmap tem o mesmo número de planos de cores ou o mesmo formato de bits por pixel que o contexto de dispositivo especificado.Pode ser selecionado sistema autônomo o bitmap corrente para qualquer dispositivo de memória é compatível com aquele especificado por pDC.

If pDC é um contexto de dispositivo de memória, o bitmap retornado tem o mesmo formato sistema autônomo bitmap selecionado no momento nesse contexto de dispositivo. Um "contexto de dispositivo de memória" é um bloco de memória que representa uma superfície de exibição.Ele pode ser usado para preparar imagens na memória antes de copiá-los para a superfície de exibição real do dispositivo compatível.

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

Como um contexto de dispositivo de memória de cores pode ter bitmaps colorida ou monocromática selecionadas, o formato de bitmap retornado pelo CreateCompatibleBitmap função não é sempre o mesmo; no entanto, o formato de um bitmap compatível para um contexto para dispositivo nonmemory é sempre no formato do dispositivo.

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CBitmap

Gráfico de hierarquia

CreateCompatibleBitmap

CGdiObject::DeleteObject

Outros recursos

CBitmap membros