CDC::MaskBlt
Combina os dados de cor para bitmaps de origem e de destino usando a operação determinada de máscara e 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 coordenada x lógica do canto superior esquerdo do retângulo alvo.s
Especifica a coordenada y lógica do canto superior esquerdo do retângulo alvo.nWidth
Especifica a largura, em unidades lógicas, bitmap do retângulo de origem e de destino.nHeight
Especifica a altura, em unidades lógicas, bitmap do retângulo de origem e de destino.pSrcDC
Identifica o contexto do dispositivo de que o bitmap deve ser copiado. Deve ser zero se o parâmetro de dwRop especifica uma operação de varredura que não inclui uma fonte.xSrc
Especifica a coordenada x lógica do canto superior esquerdo do bitmap de origem.ySrc
Especifica a coordenada y lógica do canto superior esquerdo do bitmap de origem.maskBitmap
Identifica o bitmap monocromático de máscara combinado com o bitmap de cor no contexto do dispositivo de origem.xMask
Especifica o deslocamento horizontal de pixel para o bitmap de máscara especificado pelo parâmetro de maskBitmap .yMask
Especifica o deslocamento vertical de pixel para o bitmap de máscara especificado pelo parâmetro de maskBitmap .dwRop
Especifica primeiro plano e os códigos de operação ternários de fundo de varredura, que usa a função para controlar a combinação de origem e dados de destino. O código de operação de plano de fundo de varredura é armazenado em bytes maior da palavra altas de este valor; o código de operação de varredura de primeiro plano é armazenado em baixo bytes do word altas de este valor; as palavras monitores de este valor são ignoradas, e devem ser zero. MAKEROP4 macro cria como combinações de códigos de operação de varredura de primeiro plano e plano de fundo. Consulte a seção comentários para uma discussão sobre o primeiro plano e plano de fundo no contexto da função. Consulte a função de membro de BitBlt para uma listagem de código de operação comuns de varredura.
Valor de retorno
Diferente de zero se a função é com êxito; se não 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 pelo dwRop deve ser aplicado em aquele local. Um valor de 0 na máscara indica que o código de operação de plano de fundo de varredura especificado pelo dwRop deve ser aplicado em aquele local. Se as operações de varredura requerem uma fonte, o retângulo de máscara deve abranger o retângulo de origem. Caso contrário, a função falhará. Se as operações de varredura não requerem uma fonte, o retângulo de máscara deve abranger o retângulo alvo. Caso contrário, a função falhará.
Se uma rotação ou uma transformação de tesoura é aplicado para o contexto do dispositivo de exibição source quando essa função é chamada, ocorrerá um erro. Entretanto, outros tipos de transformações são permitidos.
Se os formatos de cor, fonte do padrão, e os bitmaps de destino, converte diferem de essa função o formato padrão ou de origem, ou ambos, para coincidir com o formato de destino. Se o bitmap de máscara não é um bitmap monocromático, ocorrerá um erro. Quando meta-arquivo aprimorada está sendo gravados, um erro ocorrerá (e a função retorna 0) se o contexto de dispositivo de origem identifica um contexto do dispositivo. aprimorar- metarquivo Nem todos os dispositivos suportam MaskBlt. Um aplicativo deve chamar GetDeviceCaps para determinar se um dispositivo suporta esta função. Se nenhum bitmap de máscara é fornecido, essa função se comporta 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 ao ponto (0,0) no bitmap do contexto do dispositivo de origem. Isso é útil para casos em que um bitmap de máscara contém um conjunto de máscaras; um aplicativo pode facilmente aplicar uma de elas para uma tarefa de máscara - blitting ajustando os deslocamentos de pixel e tamanhos do retângulo enviados a MaskBlt.
Requisitos
Cabeçalho: afxwin.h