CDC::MaskBlt
Combina os dados de cor para os bitmaps de origem e de destino usando a máscara fornecida e a operação de varredura.
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 a lógica coordenada x do canto superior Esquerda canto do Retangular de destino.y
Especifica a lógica coordenada y do canto superior Esquerda canto do Retangular de destino.nWidth
Especifica a largura, em unidades lógicas, do bitmap destino Retangular e Origem.nHeight
Especifica a altura, em unidades lógicas, do bitmap destino Retangular e Origem.pSrcDC
Identifica o contexto para dispositivo do qual o bitmap está a ser copiado.Ele deve ser zero se o parâmetro de dwRop Especifica uma operação de varredura não Incluir uma Origem.xSrc
Especifica a lógica coordenada x do canto superior Esquerda canto do bitmap de origem.ySrc
Especifica a lógica coordenada y do canto superior Esquerda canto do bitmap de origem.maskBitmap
Identifica o bitmap monocromático máscara combinado com o bitmap de cor no contexto de dispositivo de origem.xMask
Especifica o deslocamento horizontal pixels para o bitmap de máscara especificado pelo parâmetro maskBitmap.yMask
Especifica o deslocamento vertical pixels para o bitmap de máscara especificado pelo parâmetro maskBitmap.dwRop
Especifica Ambos primeiro plano e plano de fundo códigos de operação de varredura ternary, que a função usa para controlar a combinação de dados de origem e destino.O código de operação de varredura de plano de fundo é armazenado no byte alto da palavra alta deste valor; o código de operação de varredura de primeiro plano é armazenado no byte baixo da palavra alta deste valor; a palavra baixa desse valor é ignorada e deve ser zero.A macro MAKEROP4 cria essas combinações de primeiro plano e plano de fundo códigos de operação de varredura.Consulte a seção " Comentários " para obter uma abordagem de primeiro plano e plano de fundo no contexto dessa função.Consulte a função de membro BitBlt para obter Comuma lista dos códigos de operação de varredura ComComumComum.
Valor de retorno
Diferente de zero se a função for bem-sucedida; caso contrário 0.
Comentários
Um valor de 1 na máscara especificada por maskBitmap indica que o código de operação de varredura de primeiro plano especificado por dwRop devem ser aplicado nesse local.Um valor de 0 na máscara indica que o código de operação de varredura Plano de Fundo especificado por dwRop devem ser aplicado nesse local.Se as operações de varredura precisar de uma fonte, o Retangular de máscara deve cobrir o Retangular de origem.Se não existir, a função irá falhar.Se as operações de varredura não precisarem de uma Origem, o Retangular de máscara deve cobrir o Retangular de destino.Se não existir, a função irá falhar.
Se uma transformação de rotação ou shear estiver em Efeito para o contexto de dispositivo Origem quando esta função é chamada, ocorrerá um erro.No entanto, outros tipos de transformações são permitidos.
Se os formatos de cor da fonte, padrão e bitmaps de destino diferem, essa função converte o padrão ou formato de origem ou ambos, para se ajustar com o formato de destino.Se o bitmap de máscara não for um bitmap monocromático, ocorrerá um erro.Quando um metarquivo avançado está sendo gravado, ocorrerá um erro (e a função retornará 0) se o contexto para dispositivo origem identifica um contexto para dispositivo-metarquivo aprimorado.Nem Tudo dispositivos suportam MaskBlt.Um aplicativo deve chamar GetDeviceCaps para determinar se um dispositivo oferece suporte a essa função.Se nenhum bitmap máscara for fornecido, essa função funciona exatamente como BitBlt, usando o código de operação de varredura de primeiro plano.O pixel desloca no mapa de bitmap de máscara para o ponto (0,0) no bitmap o contexto de dispositivo de origem.Isso é útil para casos em que um bitmap de máscara contém um conjunto de máscaras; um aplicativo pode aplicar facilmente qualquer um da uma tarefa mask-blitting ajustando os deslocamentos de pixel e tamanhos de Retangular enviados para MaskBlt.
Requisitos
Cabeçalho: afxwin.h