CBitmap::CreateBitmap

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

Valor devuelto

Distinto de cero si es correcto; caso contrario 0.

Parámetros

nWidth

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

nHeight

Especifica la altura (en píxeles) del mapa de bits.

nPlanes

Especifica el número de planos de colores en el mapa de bits.

nBitcount

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

lpBits

Puntos de una matriz de enteros de corto que contiene los valores de bit inicial de mapa de bits. Si es NULL, el nuevo mapa de bits se queda sin inicializar.

Observaciones

Inicializa un mapa de bits dependientes del dispositivo de memoria que tenga el ancho especificado, la altura y el patrón de bits.

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

Aunque un mapa de bits no se pueden seleccionar directamente de un dispositivo de visualización, puede ser seleccionado como el actual de mapa de bits para un "contexto de dispositivo de memoria" mediante el uso de CDC::SelectObject y copiado en cualquier contexto de dispositivo compatible usando la función CDC::BitBlt.

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

Para obtener más información, consulte la descripción del campo bmBits en la estructura de Mapa de bits . La estructura de Mapa de bits se describe en la función de miembro de CBitmap::CreateBitmapIndirect.

Visió&n General de CBitmap |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDC::SelectObject, CGdiObject::DeleteObject, CDC::BitBlt, :: CreateBitmap

Index