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 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 |
|---|---|
|
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 |