CreateCompatibleBitmap

Crea un mapa de bits compatible con el dispositivo asociado con el contexto de dispositivo especificado.

Sintaxis

HBITMAP CreateCompatibleBitmap(
    HDC hdc,    // manipulador de contexto de dispositivo
    int nWidth, // anchura del mapa de bits en pixels
    int nHeight // altura del mapa de bits en pixels
   );

Parámetros

hdc: identifica un contexto de dispositivo.

nWidth: especifica la anchura del mapa de bits en pixels.

nHeight: especifica la altura del mapa de bits en pixels.

Valor de retorno

Si la función tiene éxito, el valor de retorno es un manipulador del mapa de bits.

Si la función falla, el valor de retorno es NULL.

Observaciones

El formato de color del mapa de bits creado por esta función coincide con el formato de color del dispositivo identificado por el parámetro hdc. Este mapa de bits puede ser seleccionado para un contexto de dispositivo de memoria que sea compatible con el dispositivo original.

Como el contexto de dispositivo de memoria permite tanto mapas de bits monocromos como de color, el formato del mapa de bits devuelto por CreateCompatibleBitmap es distinto cuando el contexto de dispositivo especificado es de memoria. En cualquier caso, un mapa de bits compatible creado para un contexto de dispositivo que no sea de memoria siempre poseerá el mismo formato de color y usará la misma paleta de colore que el contexto de dispositivo especificado.

Si una aplicación pone el parámetro nWidth o nHeight a cero, CreateCompatibleBitmap devolverá un manipulador de un mapa de bits monocromo de un pixel por un pixel.

Si una sección DIB, que es un mapa de bits creado mediante la función CreateDIBSection, es seleccionado dentro de un contexto de dispositivo identificado por el parámetro hdc, la función CreateCompatibleBitmap creará una sección DIB.

Cuando ya no se necesite el mapa de bits, hay que llamar a la función DeleteObject para borrarlo.