Compartir a través de


CBitmap::CreateBitmap

Inicializa un mapa de bits dispositivo- dependiente de memoria que tiene el ancho especificado, el alto, y la configuración de bits.

BOOL CreateBitmap( 
   int nWidth, 
   int nHeight, 
   UINT nPlanes, 
   UINT nBitcount, 
   const void* lpBits  
);

Parámetros

  • nWidth
    Especifica el ancho (en píxeles) del mapa de bits.

  • nHeight
    Especifica el alto (en píxeles) del mapa de bits.

  • nPlanes
    Especifica el número de aviones en el mapa de bits.

  • nBitcount
    Especifica el número de bits de color por píxel de la pantalla.

  • lpBits
    Señala a una matriz de bytes que contiene los valores de bit bitmap iniciales. Si es nulo, el nuevo mapa de bits se deja sin inicializar.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

Para un mapa de bits de color, nPlanes o el parámetro de nBitcount debe establecerse en 1. Si ambos parámetros se establecen en 1, CreateBitmap crea un mapa de bits monocromo.

Aunque un mapa de bits no se puede seleccionar directamente para un dispositivo de pantalla, puede seleccionar como el mapa de bits actual para “un contexto de dispositivo de memoria” utilizando CDC::SelectObject y copiar en cualquier contexto compatible de dispositivo mediante la función de CDC::BitBlt.

Cuando termine con el objeto de CBitmap creado por la función de CreateBitmap, seleccione primero el mapa de bits fuera del contexto de dispositivo, se elimina el objeto de CBitmap.

Para obtener más información, vea la descripción del campo bmBits en la estructura BITMAP. La estructura de MAPA OF BITS se describe en función de miembro de CBitmap::CreateBitmapIndirect.

Requisitos

Header: afxwin.h

Vea también

Referencia

CBitmap Class

Gráfico de jerarquías

CDC::SelectObject

CGdiObject::DeleteObject

CDC::BitBlt

CreateBitmap