Función CreateCompatibleBitmap (wingdi.h)

Artículo
03/08/2023

La función CreateCompatibleBitmap crea un mapa de bits compatible con el dispositivo asociado al contexto de dispositivo especificado.

Sintaxis

HBITMAP CreateCompatibleBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parámetros

[in] hdc

Identificador de un contexto de dispositivo.

[in] cx

Ancho del mapa de bits, en píxeles.

[in] cy

Alto del mapa de bits, en píxeles.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el mapa de bits compatible (DDB).

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

El formato de color del mapa de bits creado por la función CreateCompatibleBitmap coincide con el formato de color del dispositivo identificado por el parámetro hdc . Este mapa de bits se puede seleccionar en cualquier contexto de dispositivo de memoria compatible con el dispositivo original.

Dado que los contextos de dispositivo de memoria permiten mapas de bits de color y monocromáticos, el formato del mapa de bits devuelto por la función CreateCompatibleBitmap difiere cuando el contexto de dispositivo especificado es un contexto de dispositivo de memoria. Sin embargo, un mapa de bits compatible que se creó para un contexto de dispositivo nomory siempre posee el mismo formato de color y usa la misma paleta de colores que el contexto de dispositivo especificado.

Nota: Cuando se crea un contexto de dispositivo de memoria, inicialmente tiene seleccionado un mapa de bits monocromo de 1 a 1. Si este contexto de dispositivo de memoria se usa en CreateCompatibleBitmap, el mapa de bits que se crea es un mapa de bits monocromático . Para crear un mapa de bits de color, use la HDC que se usó para crear el contexto del dispositivo de memoria, como se muestra en el código siguiente:


    HDC memDC = CreateCompatibleDC ( hDC );
    HBITMAP memBM = CreateCompatibleBitmap ( hDC, nWidth, nHeight );
    SelectObject ( memDC, memBM );

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

Si una sección DIB, que es un mapa de bits creado por la función CreateDIBSection , se selecciona en el contexto del dispositivo identificado por el parámetro hdc , CreateCompatibleBitmap crea una sección DIB.

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

Ejemplos

Para obtener un ejemplo, consulte Escalado de una imagen.

Requisitos

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