CDC::PlgBlt
Realiza una transferencia de bloque de bits de los bits de los datos de color del rectángulo especificado en el contexto del dispositivo de origen al paralelogramo especificado en el contexto determinado del dispositivo.
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
Parámetros
lpPoint
Señala a una matriz de tres puntos en el espacio lógico que identifica tres esquinas del paralelogramo de destino.La esquina superior izquierda del rectángulo de origen se asigna al primer punto de esta matriz, a la esquina superior derecha al segundo punto de esta matriz, y a la esquina inferior izquierda el tercer punto.La esquina inferior derecha del rectángulo de origen se asigna al cuarto punto implícitamente en el paralelogramo.pSrcDC
Identifica el contexto del dispositivo de origen.xSrc
Especifica la coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.ySrc
Especifica la coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.nWidth
Especifica el ancho, en unidades lógicas, el rectángulo de origen.nHeight
Especifica el alto, en unidades lógicas, el rectángulo de origen.maskBitmap
Identifica un mapa de bits monocromo opcional que se utiliza para la máscara los colores del rectángulo de origen.xMask
Especifica la coordenada x de la esquina superior izquierda del mapa de bits monocromo.yMask
Especifica la coordenada y de la esquina superior izquierda del mapa de bits monocromo.
Valor devuelto
Distinto de cero si la función es correcta; si no 0.
Comentarios
Si el identificador especificado de la máscara de bits identifica un mapa de bits monocromo válido, la función utiliza este mapa de bits a la máscara los bits de los datos de color del rectángulo de origen.
El cuarto vértice del paralelogramo (d) se define trata los primeros tres puntos (A, b, y C) como vectores y C d el calcular = b + - A.
Si existe la máscara de bits, un valor de 1 en la máscara indica que el píxel color de origen se debe copiar en el destino.Un valor de 0 en la máscara indica que el píxel color de destino no debe cambiar.
Si el rectángulo de máscara es menor que los rectángulos de origen y de destino, la función replica el patrón de máscara.
El ajuste de escala, la traducción, y las transformaciones de reflexión se permiten en el contexto del dispositivo de origen; sin embargo, el giro y las transformaciones de distorsión no.Si el mapa de bits de la máscara no es un mapa de bits monocromo, se produce un error.Utilizan el modo de ajuste para el contexto del dispositivo de destino para determinar cómo ajustar o comprimir los píxeles, si eso es necesario.Cuando se registra un metarchivo mejorado, se produce un error si el contexto del dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado.
Las coordenadas de destino se transforman según el contexto del dispositivo de destino; las coordenadas de origen se transforman según el contexto del dispositivo de origen.Si la transformación de origen tiene una rotación o un distorsión, se devuelve un error.Si los rectángulos de origen y de destino no tienen el mismo formato de color, PlgBlt convierte el rectángulo de origen para que coincida con el rectángulo de destino.No todos los dispositivos PlgBltadmiten.Para obtener más información, vea la descripción de la capacidad de la trama de RC_BITBLT en la función miembro de CDC::GetDeviceCaps .
Si los contextos de dispositivo de origen y de destino representan los dispositivos incompatibles, PlgBlt devuelve un error.
Requisitos
encabezado: afxwin.h