Función CreateBitmap (wingdi.h)

La función CreateBitmap crea un mapa de bits con el formato de ancho, alto y color especificados (planos de color y bits por píxel).

Sintaxis

HBITMAP CreateBitmap(
  [in] int        nWidth,
  [in] int        nHeight,
  [in] UINT       nPlanes,
  [in] UINT       nBitCount,
  [in] const VOID *lpBits
);

Parámetros

[in] nWidth

Ancho del mapa de bits, en píxeles.

[in] nHeight

Alto del mapa de bits, en píxeles.

[in] nPlanes

Número de planos de color utilizados por el dispositivo.

[in] nBitCount

Número de bits necesarios para identificar el color de un solo píxel.

[in] lpBits

Puntero a una matriz de datos de color utilizados para establecer los colores en un rectángulo de píxeles. Cada línea de examen del rectángulo debe estar alineada con palabras (las líneas de examen que no están alineadas por palabras deben rellenarse con ceros). El tamaño de búfer esperado, cj, se puede calcular mediante la fórmula :

cj = (((nWidth * nPlanes * nBitCount + 15) >> 4) << 1) * nHeight;

Si este parámetro es NULL, el contenido del nuevo mapa de bits no está definido.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador de un mapa de bits.

Si se produce un error en la función, el valor devuelto es NULL.

Esta función puede devolver el siguiente valor.

Código devuelto Descripción
ERROR_INVALID_BITMAP
El tamaño calculado del mapa de bits es menor que cero.

Observaciones

La función CreateBitmap crea un mapa de bits dependiente del dispositivo.

Una vez creado un mapa de bits, se puede seleccionar en un contexto de dispositivo llamando a la función SelectObject . Sin embargo, el mapa de bits solo se puede seleccionar en un contexto de dispositivo si el mapa de bits y el controlador de dominio tienen el mismo formato.

La función CreateBitmap se puede usar para crear mapas de bits de color. Sin embargo, por motivos de rendimiento, las aplicaciones deben usar CreateBitmap para crear mapas de bits monocromáticos y CreateCompatibleBitmap para crear mapas de bits de color. Cada vez que se selecciona un mapa de bits de color devuelto desde CreateBitmap en un contexto de dispositivo, el sistema comprueba que el mapa de bits coincide con el formato del contexto del dispositivo en el que se selecciona. Dado que CreateCompatibleBitmap toma un contexto de dispositivo, devuelve un mapa de bits que tiene el mismo formato que el contexto de dispositivo especificado. Por lo tanto, las llamadas posteriores a SelectObject son más rápidas con un mapa de bits de color de CreateCompatibleBitmap que con un mapa de bits de color devuelto desde CreateBitmap.

Si el mapa de bits es monocromo, los ceros representan el color de primer plano y los que representan el color de fondo para el contexto del dispositivo de destino.

Si una aplicación establece los parámetros nWidth o nHeight en cero, CreateBitmap devuelve el identificador a un mapa de bits monocromo de 1 a 1 píxel.

Cuando ya no necesite el mapa de bits, llame a la función DeleteObject para eliminarlo.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Vea también

Funciones de mapa de bits

Información general sobre mapas de bits

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBitmap

DeleteObject

GetBitmapBits

SelectObject

SetBitmapBits