Función CreateBitmap (wingdi.h)

Artículo
03/08/2023

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 la función no se realiza correctamente, 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.

Comentarios

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

Después de crear 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