CDC::MaskBlt

BOOL M&askBlt ( int x, int y, int nWidth, int nHeight, CDC * pSrcDC, int xSrc, int ySrc, CBitmapamp; maskBitmap, int xMask, int yMask, 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 la anchura, 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

Identifica el contexto de dispositivo desde el que el mapa de bits es copiarse. Debe ser cero si el parámetro 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.

maskBitmap

Identifica el mapa de bits monocromo máscara combinado con el mapa de bits de color en el contexto de dispositivo de origen.

xMask

Especifica el desplazamiento horizontal de píxeles para la máscara de mapa de bits especificado por el parámetro maskBitmap.

yMask

Especifica el desplazamiento vertical de píxeles para la máscara de mapa de bits especificado por el parámetro maskBitmap.

dwRop

Especifica el primer y segundo plano raster ternaria códigos de operación, que la función se utiliza para controlar la combinación de datos de origen y destino. El código de operación de trama de fondo se almacena en el byte alto de la palabra alta de este valor; el código de operación de primer plano raster se almacena en el byte bajo de la palabra alta de este valor; la palabra baja de este valor se omite y debe ser cero. La macro MAKEROP4 crea dichas combinaciones de primer y segundo plano códigos de operación de rasterizado. Vea la sección Comentarios para una discusión de primer plano y de fondo en el contexto de esta función. Vea la función de miembro de BitBlt para obtener una lista de los códigos de operación raster comunes.

Observaciones

Combina los datos de color de los mapas de bits de origen y de destino utilizando la máscara determinada y el funcionamiento de rasterizado. Un valor de 1 en la máscara especificada por maskBitmap indica que debe aplicarse el código de operación de rasterizado de primer plano especificado por dwRop en esa ubicación. Un valor de 0 en la máscara indica que debe aplicarse el código de operación de la trama de fondo especificado por dwRop en esa ubicación. Si las operaciones paralelas requieren una fuente, el rectángulo de máscara debe cubrir el rectángulo de origen. Si no lo hace, se producirá un error en la función. Si las operaciones paralelas no requieren una fuente, el rectángulo de máscara debe cubrir el rectángulo de destino. Si no lo hace, se producirá un error la función.

Si una transformación de rotación o distorsión está en efecto para el contexto de dispositivo de origen cuando se llama a esta función, se produce un error. Sin embargo, se permiten otros tipos de transformaciones.

Si difieren los formatos de color de la fuente, patrón y mapas de bits de destino, esta función convierte el patrón de formato de fuente o ambos, para que coincida con el formato de destino. Si el mapa de bits máscara no es un mapa de bits monocromo, se produce un error. Cuando se registra un metarchivo mejorado, se produce un error (y la función devuelve el valor 0) si el contexto de dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado. No todos los dispositivos admiten MaskBlt. Una aplicación debe llamar a GetDeviceCaps para determinar si un dispositivo admite esta función. Si no se suministra ningún mapa de bits máscara, esta función se comporta exactamente como BitBlt, utilizando el código de operación de rasterizado de primer plano. El píxel se desplaza en el máscara de mapa de bits mapa para el punto (0,0) en mapa de bits del contexto de dispositivo de origen. Esto es útil para los casos en que un mapa de bits máscara contiene un conjunto de máscaras; una aplicación puede aplicar fácilmente uno de ellos a una tarea de máscara blitting ajustando los desvíos de píxeles y tamaños de rectángulo enviados a MaskBlt.

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

Vea tambiénnbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::PlgBlt, CDC::StretchBlt, :: MaskBlt

Index