Função CreateCompatibleBitmap (wingdi.h)

Artigo
03/08/2023

A função CreateCompatibleBitmap cria um bitmap compatível com o dispositivo associado ao contexto do dispositivo especificado.

Sintaxe

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parâmetros

[in] hdc

Um identificador para um contexto de dispositivo.

[in] cx

A largura do bitmap, em pixels.

[in] cy

A altura do bitmap, em pixels.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o DDB (bitmap) compatível.

Se a função falhar, o valor retornado será NULL.

Comentários

O formato de cor do bitmap criado pela função CreateCompatibleBitmap corresponde ao formato de cor do dispositivo identificado pelo parâmetro hdc . Esse bitmap pode ser selecionado em qualquer contexto de dispositivo de memória compatível com o dispositivo original.

Como os contextos de dispositivo de memória permitem bitmaps de cor e monocromáticos, o formato do bitmap retornado pela função CreateCompatibleBitmap difere quando o contexto do dispositivo especificado é um contexto de dispositivo de memória. No entanto, um bitmap compatível que foi criado para um contexto de dispositivo não teórico sempre possui o mesmo formato de cor e usa a mesma paleta de cores que o contexto do dispositivo especificado.

Observação: quando um contexto de dispositivo de memória é criado, ele inicialmente tem um bitmap monocromático 1 por 1 selecionado nele. Se esse contexto de dispositivo de memória for usado em CreateCompatibleBitmap, o bitmap criado será um bitmap monocromático . Para criar um bitmap de cor, use o HDC que foi usado para criar o contexto do dispositivo de memória, conforme mostrado no código a seguir:


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

Se um aplicativo definir os parâmetros nWidth ou nHeight como zero, CreateCompatibleBitmap retornará o identificador para um bitmap monocromático de 1 por 1 pixel.

Se uma seção DIB, que é um bitmap criado pela função CreateDIBSection , for selecionada no contexto do dispositivo identificado pelo parâmetro hdc , CreateCompatibleBitmap criará uma seção DIB.

Quando você não precisar mais do bitmap, chame a função DeleteObject para excluí-la.

Exemplos

Para obter um exemplo, consulte Dimensionando uma imagem.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll