CDC::BitBlt

Artículo
02/19/2013

Copia un mapa de bits de contexto del dispositivo de origen a este contexto actual del dispositivo.

BOOL BitBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   DWORD dwRop 
);

Parámetros

x
Especifica la coordenada x lógica de la esquina superior izquierda del rectángulo de destino.
y
Especifica la coordenada y lógica de la esquina superior izquierda del rectángulo de destino.
nWidth
Especifica el ancho (en unidades lógicas) del mapa de bits del rectángulo y el origen del destino.
nHeight
Especifica el alto (en unidades lógicas) del mapa de bits del rectángulo y el origen del destino.
pSrcDC
Puntero a un objeto de CDC que identifica el contexto del dispositivo que el mapa de bits se copiará.Debe ser NULL si el dwRop especifica una operación de la trama que no incluya un origen.
xSrc
Especifica la coordenada x lógica de la esquina superior izquierda del mapa de bits de origen.
ySrc
Especifica la coordenada y lógica de la esquina superior izquierda del mapa de bits de origen.
dwRop
Especifica la operación de la trama que se va a realizar.Los códigos de la Trama- operación definen cómo GDI combina colores en operaciones de salida que implican un pincel actual, un mapa de bits posible de origen, y un mapa de bits de destino.Vea BitBlt en Windows SDK para una lista de los códigos de la trama- operación para el dwRop y sus descripciones

Para obtener una lista completa de códigos de la trama- operación, vea Sobre los códigos de operación de la trama en Windows SDK.

Valor devuelto

Distinto de cero si la función es correcta; si no 0.

Comentarios

La aplicación puede clasificar las ventanas o áreas cliente en límites de byte para garantizar que las operaciones de BitBlt aparecen en rectángulos byte- alineado.(Se establece los marcadores de CS_BYTEALIGNWINDOW o de CS_BYTEALIGNCLIENT cuando registra las clases de ventana).

Las operaciones deBitBlt en rectángulos byte- alineado son mucho más rápidas que las operaciones de BitBlt en los rectángulos que no son bytes alineado.Si desea especificar estilos de clase como byte- alineación para su propio contexto de dispositivo, tendrá que registrar una clase de ventana en lugar de confiar en las clases base de Microsoft para hacer automáticamente.Utilice la función global Clase.

GDI transforma nWidth y nHeight, una vez utilizando el contexto del dispositivo de destino, y una vez utilizando el contexto del dispositivo de origen.Si no coinciden las extensiones resultantes, GDI utiliza la función de Windows StretchBlt para comprimir o ajustar el mapa de bits de origen según sea necesario.

Si el destino, el origen, y los mapas de bits de modelo no tienen el mismo formato de color, se convierten de la función de BitBlt el origen y mapas de bits del modelo para que coincida con el destino.Los colores de primer plano y de fondo del mapa de bits de destino se utilizan en la conversión.

Cuando la función de BitBlt convierte un mapa de bits monocromo para colorear, establece los bits blancos (1) a los bits del color de fondo y negro (0) al color de primer plano.Los colores de primer plano y de fondo del contexto del dispositivo de destino se utilizan.Para convertir el color en monocromático, píxeles de los conjuntos de BitBlt que coincidan con el color de fondo en blanco y establece el resto de los píxeles a negro.BitBlt utiliza los colores de primer plano y de fondo del contexto de color del dispositivo para convertir del color en monocromático.

Tenga en cuenta que no todos los contextos de dispositivo admiten BitBlt.Para comprobar si un contexto determinado de dispositivo admite BitBlt, utilice la función miembro de GetDeviceCaps y especifique el índice de RASTERCAPS .