CreateCompatibleBitmap

9/9/2008

Essa função cria um bitmap compatível com o dispositivo associado com o contexto dispositivo especificado.

Syntax

HBITMAP CreateCompatibleBitmap(
  HDC hdc, 
  int nWidth, 
  int nHeight
); 

Parameters

• hDC
  [no] Identificador para um contexto dispositivo.

• nWidth
  [no] Especifica a largura bitmap, em pixels.

• nHeight
  [no] Especifica a altura bitmap, em pixels.

Return Value

Um identificador para o bitmap indica sucesso.

NULL Indica falha.

Para informações de erro estendidas get, chamar GetLastError.

Exemplo de código

O seguinte exemplo de código mostra como criar um contexto dispositivo memória e como usar um CreateCompatibleBitmap Para criar um bitmap.

  HDC hDC,                  // Handle to the display device context 
      hDCMem;               // Handle to the memory device context
  HBITMAP hBitmap;          // Handle to the new bitmap
  int iWidth, iHeight;      // Width and height of the bitmap
  // Retrieve the handle to a display device context for the client 
  // area of the window. 
  hDC = GetDC (hwnd);
  // Create a memory device context compatible with the device. 
  hDCMem = CreateCompatibleDC (hDC);
  // Retrieve the width and height of window display elements.
  iWidth = GetSystemMetrics (SM_CXSCREEN) / 10;
  iHeight = GetSystemMetrics (SM_CYSCREEN) / 10;
  // Create a bitmap compatible with the device associated with the 
  // device context.
  hBitmap = CreateCompatibleBitmap (hDC, iWidth, iHeight);
// Insert code to use the bitmap.
  // Delete the bitmap object and free all resources associated with it. 
  DeleteObject (hBitmap);
  // Delete the memory device context and the display device context.
  DeleteDC (hDCMem);
  ReleaseDC (hDC);

Remarks

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

Como contextos dispositivo memória permitir tanto cor monocromático bitmaps, o formato do bitmap retornado pela CreateCompatibleBitmap função difere quando as contexto para dispositivo especificado é um contexto dispositivo memória. No entanto, um compatível bitmap que foi criada para um contexto dispositivo nonmemory sempre possua o mesmo formato cor e usa o mesmo paleta de cores como contexto de dispositivo especificado.

Se um aplicativo define o nWidth Ou nHeight Parâmetros para zero, CreateCompatibleBitmap Retorna o identificador para um 1 - por 1 - pixel, bitmap monocromático.

Se uma seção bitmap independente de dispositivo (DIB), que é um bitmap criado pela CreateDIBSection função, está selecionada no contexto de dispositivo identificado pelo hDC parâmetro, CreateCompatibleBitmap Cria uma seção bitmap independente de dispositivo (DIB).

Quando você mais necessário o bitmap, chamar o ExcluirObjeto função para excluí-lo.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateDIBSection
DeleteObject
SelectObject
GDI Functions