CDC::StretchBlt

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

Valor devuelto

Distinto de cero si se dibuja el mapa de bits; caso contrario 0.

Parámetros

x

Especifica la coordenada x (en unidades lógicas) de la esquina superior izquierda del rectángulo de destino.

y

Especifica la coordenada y (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 la altura (en unidades lógicas) del rectángulo de destino.

pSrcDC

Especifica el contexto de 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 x (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 la altura (en unidades lógicas) del rectángulo de origen.

dwRop

Especifica la operación raster a realizarse. Códigos de operación raster definir cómo 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. Este parámetro puede ser uno de los siguientes valores:

Observaciones

Un mapa de bits de un rectángulo de origen se copia en un rectángulo de destino, estirar o comprimir el mapa de bits si es necesario para ajustarse a las dimensiones del rectángulo de destino. La función utiliza el modo de estiramiento del contexto de dispositivo de destino (establecido por SetStretchBltMode) para determinar cómo estirar o comprimir el mapa de bits.

La función StretchBlt mueve el mapa de bits desde el dispositivo de origen dado por pSrcDC en el dispositivo de destino representado por el objeto de contexto de dispositivo se llama cuya función miembro. Los parámetros xSrc, ySrc, nSrcWidthy nSrcHeight definen la esquina superior izquierda y las dimensiones del rectángulo de origen. Los parámetros x, y, nWidthy nHeight dan a la esquina superior izquierda y las dimensiones del rectángulo de destino. La operación de mapa de bits especificada por dwRop define cómo se combinan la fuente de mapa de bits y los bits ya en el dispositivo de destino.

La función StretchBlt crea una imagen reflejada de un mapa de bits si difieren de los signos de los parámetros nSrcWidth y nWidth o nSrcHeight y nHeight . Si nSrcWidth y nWidth tienen diferentes signos, la función crea una imagen reflejada de mapa de bits a lo largo del eje x. Si nSrcHeight y nHeight tienen diferentes signos, la función crea una imagen reflejada de mapa de bits a lo largo del eje y.

La función StretchBlt se estira o comprime el mapa de bits de origen en la memoria y copia el resultado en el destino. Si un patrón es para combinarse con el resultado, no se fusionan hasta el mapa de bits estirada de origen se copia en el destino. Si se utiliza un pincel, es el pincel seleccionado en el contexto de dispositivo de destino. Las coordenadas de destino se transforman de acuerdo al contexto de dispositivo de destino; las coordenadas de origen se transforman de acuerdo al contexto de dispositivo de origen.

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

Si StretchBlt debe convertir 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. Para convertir el color en monocromo, establece los píxeles que coinciden con el color de fondo a blanco (1) y todos los píxeles al negro (0). Se utilizan los colores frontal y de fondo el contexto de dispositivo con color.

No todos los dispositivos admiten la función de StretchBlt . Para determinar si un dispositivo admite StretchBlt, llame a la función miembro GetDeviceCaps con el índice RASTERCAPS y comprobar el valor devuelto por la bandera RC_STRETCHBLT.

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

Vea tambiénnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt

Index