CDC::MaskBlt
Combina los datos de color de mapas de bits de origen y de destino utilizando la operación especificada de máscara y la trama.
BOOL MaskBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
CBitmap& maskBitmap,
int xMask,
int yMask,
DWORD dwRop
);
Parámetros
x
Especifica la coordenada x lógica 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, el mapa de bits del rectángulo y el origen del destino.nHeight
Especifica el alto, en unidades lógicas, el mapa de bits del rectángulo y el origen del destino.pSrcDC
Identifica el contexto del dispositivo que el mapa de bits se debe copiar. Debe ser cero si el parámetro de dwRop especifica una operación de la trama que no incluya un origen.xSrc
Especifica la coordenada x lógica de la esquina superior izquierda del mapa de bits de origen.ySrc
Especifica la coordenada y lógica de la esquina superior izquierda del mapa de bits de origen.maskBitmap
Identifica el mapa de bits monocromático de máscara combinado con el mapa de bits en el contexto del dispositivo de origen.xMask
Especifica el desplazamiento horizontal de píxeles del mapa de bits de la máscara especificado por el parámetro de maskBitmap .yMask
Especifica el desplazamiento vertical de píxeles del mapa de bits de la máscara especificado por el parámetro de maskBitmap .dwRop
Especifica los códigos de operación ternarios de la trama de primer plano y de fondo, que la función utiliza para controlar la combinación de origen y de datos de destino. El código de operación de la trama de fondo se almacena en el alto byte de gran palabra de este valor; el código de operación de la trama de primer plano se almacena en el byte bajo de gran palabra de este valor; la palabra baja de este valor se omite, y debe ser cero. MAKEROP4 macro crea como combinaciones de códigos de operación de la trama de primer plano y de fondo. Vea la sección comentarios para obtener una explicación de primer plano y de fondo en el contexto de esta función. Vea el miembro de BitBlt trabajar para una lista de códigos de operación comunes de la trama.
Valor devuelto
Distinto de cero si la función es correcta; si no 0.
Comentarios
Un valor de 1 en la máscara especificada por maskBitmap indica que el código de operación de la trama de primer plano especificado por el dwRop se debe aplicar a esa ubicación. Un valor de 0 en la máscara indica que el código de operación de la trama de fondo especificado por el dwRop se debe aplicar a esa ubicación. Si las operaciones de la trama requieren un origen, el rectángulo de la máscara debe cubrir el rectángulo de origen. Si no hace, la función producirá un error. Si las operaciones de la trama no requieren un origen, el rectángulo de la máscara debe cubrir el rectángulo de destino. Si no hace, la función producirá un error.
Si una rotación o una transformación de distorsión está en vigor para el contexto del dispositivo de origen cuando se llama a esta función, se produce un error. sin embargo, se permite a otros tipos de transformaciones.
Si entre los formatos de color de origen, del modelo, y los mapas de bits de destino, esta función convierte el formato del modelo o de origen, o ambos, para coincidir con el formato del destino. Si el mapa de bits de la 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 0) si el contexto del dispositivo de origen identifica un contexto de dispositivo de metarchivo mejorado. No todos los dispositivos MaskBltadmiten. Una aplicación debe llamar a GetDeviceCaps para determinar si las admita el dispositivo esta función. Si no se proporciona un mapa de bits de la máscara, esta función se comporta exactamente como BitBlt, mediante el código de operación de la trama de primer plano. Los desplazamientos de píxeles del mapa del mapa de bits de la máscara al punto (0,0) en el mapa de bits del origen de contexto del dispositivo. Esto es útil para los casos en los que un mapa de bits de la máscara contiene un conjunto de máscaras; una aplicación aplicar con facilidad de ellos a una tarea de la máscara-blitting ajustando los desplazamientos de píxel y tamaños de rectángulo enviados a MaskBlt.
Requisitos
encabezado: afxwin.h