CDC::BitBlt 

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

Valor devuelto

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

Parámetros

x

Especifica la lógica coordenada x 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 origen y el rectángulo de destino.

nHeight

Especifica la altura (en unidades lógicas) del mapa de origen y el rectángulo de destino.

pSrcDC

Puntero a un objeto de CDC que identifica el contexto de dispositivo desde el que se copiará el mapa de bits. Debe ser nulo si dwRop especifica una operación de trama que no incluya una fuente.

xSrc

Especifica la lógica coordenada x de la esquina superior izquierda del mapa de origen.

ySrc

Especifica la coordenada y lógica de la esquina superior izquierda del mapa de origen.

dwRop

Especifica la operación raster a realizarse. Códigos de operación raster definen cómo la GDI combina colores en las operaciones de salida que implican un pincel actual, un mapa de bits posible fuente y un mapa de bits de destino. Los siguientes códigos de operación raster listas para dwRop y sus descripciones:

Para obtener una lista completa de códigos de operación raster, consulte códigos de operación sobre la trama en la sección de apéndices de la referencia del programador del SDK de Win32.

Observaciones

Copia de un mapa de bits desde el contexto de dispositivo de origen en este contexto de dispositivo actual.

La aplicación puede alinear el windows o áreas de cliente en límites de bytes para asegurar que las operaciones BitBlt ocurren en rectángulos bytes alineados. (Establecer los indicadores CS_BYTEALIGNWINDOW o CS_BYTEALIGNCLIENT al registrar las clases de ventana).

Operaciones BitBlt en rectángulos bytes alineados son considerablemente más rápido que operaciones BitBlt en rectángulos que no están alineado de byte. Si desea especificar los estilos de clase como byte-alineación para su propio contexto de dispositivo, tendrá que registrar una clase de ventana en lugar de depender de las Microsoft Foundation classes para hacerlo por usted. Utilice la función global AfxRegisterWndClass.

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

Si no tiene el mismo formato de color de destino, origen y patrón de mapas de bits, la función BitBlt convierte los mapas de bits de origen y patrón para que coincida con el destino. Los colores frontal y de fondo de mapa de bits de destino se utilizan en la conversión.

Cuando la función BitBlt convierte un mapa de bits monocromo en color, establece bits blancos (1) para el color de fondo y bits negros (0) para el color de primer plano. Se utilizan los colores frontal y de fondo del contexto de dispositivo de destino. Para convertir el color en monocromo, BitBlt establece píxeles que coinciden con el color de fondo a blanco y todos los píxeles negros. BitBlt utiliza los colores frontal y de fondo del contexto de dispositivo de color para convertir de color a monocromo.

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

Visió&n General de CDC |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CDC::GetDeviceCaps, CDC::PatBlt, CDC::SetTextColor, CDC::StretchBlt, :: StretchDIBits, :: BitBlt

Index