CDC::StretchBlt
Copia un mapa de bits de un rectángulo de origen en un rectángulo de destino, estirando o comprima el mapa de bits en caso necesario para ajustarse las dimensiones del rectángulo de destino.
BOOL StretchBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nSrcWidth,
int nSrcHeight,
DWORD dwRop
);
Parámetros
x
Especifica la x- coordenada (en unidades lógicas) de la esquina superior izquierda del rectángulo de destino.y
Especifica la y- coordenada (en unidades lógicas) de la esquina superior izquierda del rectángulo de destino.nWidth
Especifica el ancho (en unidades lógicas) del rectángulo de destino.nHeight
Especifica el alto (en unidades lógicas) del rectángulo de destino.pSrcDC
Especifica el contexto del dispositivo de origen.xSrc
Especifica la x- coordenada (en unidades lógicas) de la esquina superior izquierda del rectángulo de origen.ySrc
Especifica la x- coordenada (en unidades lógicas) de la esquina superior izquierda del rectángulo de origen.nSrcWidth
Especifica el ancho (en unidades lógicas) del rectángulo de origen.nSrcHeight
Especifica el alto (en unidades lógicas) del rectángulo de origen.dwRop
Especifica la operación de la trama que se va a realizar.Los códigos de operación de la trama 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.Este parámetro puede tener uno de los siguientes valores:BLACKNESS gira todo el negro de salida.
DSTINVERT invierte el mapa de bits de destino.
MERGECOPY Combines el modelo y el origen traza una correspondencia de bits utilizando el operador booleano AND.
MERGEPAINT Combines el mapa de bits invertido de origen con el mapa de bits de destino utilizando el tipo booleano OR el operador.
NOTSRCCOPY copia el mapa de bits invertido de origen al destino.
NOTSRCERASE invierte el resultado de combinar los mapas de bits de origen y de destino utilizando el tipo booleano OR el operador.
PATCOPY copia el modelo al mapa de bits de destino.
PATINVERT Combines el mapa de bits de destino con el modelo mediante el operador booleano XOR.
PATPAINT Combines el mapa de bits invertido de origen con el modelo mediante el tipo booleano OR el operador.Combina el resultado de la operación con el mapa de bits de destino utilizando el tipo booleano OR el operador.
Píxeles deSRCAND Combines de mapas de bits de origen y de destino utilizando el operador booleano AND.
SRCCOPY copia el mapa de bits de origen al mapa de bits de destino.
SRCERASE invierte el mapa de bits de destino y combina el resultado al mapa de bits de origen utilizando el operador booleano AND.
Píxeles deSRCINVERT Combines de mapas de bits de origen y de destino utilizando el operador booleano XOR.
Píxeles deSRCPAINT Combines de mapas de bits de origen y de destino utilizando el tipo booleano OR el operador.
WHITENESS gira todo el blanco de salida.
Valor devuelto
Distinto de cero si se dibuja el mapa de bits; si no 0.
Comentarios
La función utiliza el modo de ajuste del contexto del dispositivo de destino (establecido por SetStretchBltMode) para determinar cómo ajustar o comprimir el mapa de bits.
La función de StretchBlt mueve el mapa de bits del dispositivo de origen proporcionado por pSrcDC el dispositivo de destino representado por el objeto de dispositivo- contexto cuya se llama a la función miembro.xSrc, ySrc, nSrcWidth, y los parámetros de nSrcHeight definen la esquina superior izquierda y las dimensiones del rectángulo de origen.El x, y, nWidth, y los parámetros de nHeight proporcionan la esquina superior izquierda y las dimensiones del rectángulo de destino.La operación de la trama especificada por el dwRop define cómo el mapa de bits de origen y los bits ya en el dispositivo de destino se combinan.
La función de StretchBlt crea una imagen reflejada de un mapa de bits si difieren signos de nSrcWidth y nWidth o nSrcHeight y los parámetros de nHeight .Si nSrcWidth y nWidth tienen diferentes signos, la función crea una imagen reflejada del mapa de bits a lo largo del eje X.Si nSrcHeight y nHeight tienen diferentes signos, la función crea una imagen reflejada del mapa de bits a lo largo del eje Y.
La función de StretchBlt ajusta o comprime el mapa de bits de origen en memoria y copie el resultado al destino.Si se va un modelo a combinarse con el resultado, no se combina hasta que el mapa de bits estirado de origen se copie al destino.Si se utiliza un pincel, es el pincel seleccionado en el contexto del dispositivo de destino.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 el destino, el origen, y los mapas de bits de modelo no tienen el mismo formato de color, se convierten de StretchBlt los mapas de bits de origen y de modelo para que coincida con el destino trazan un mapa de bits.Los colores de primer plano y de fondo del contexto del dispositivo de destino se utilizan en la conversión.
Si StretchBlt debe convertir 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.Para convertir el color en monocromático, establece los píxeles que coincidan con el color de fondo en blanco (1) y establece el resto de los píxeles en negro (0).Los colores de primer plano y de fondo del contexto de dispositivos con colores se utilizan.
no todos los dispositivos admiten la función de StretchBlt .Para determinar si las admita el dispositivo StretchBlt, llame a la función miembro de GetDeviceCaps con el índice de RASTERCAPS y compruebe el valor devuelto para el marcador de RC_STRETCHBLT .
Requisitos
encabezado: afxwin.h