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 de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

x

Especifica o x lógica-coordenar de upper-Esquerda canto do Retangular de destino.

y

Especifica a y lógica-coordenar de upper-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 de dispositivo do qual o bitmap deve ser copiado. Ele deve ser zero se a dwRop parâmetro especifica uma operação de varredura que não inclui uma origem.

xSrc

Especifica o x lógica-coordenar de upper-Esquerda canto of the bitmap origem.

ySrc

Especifica a y lógica-coordenar de upper-Esquerda canto of the bitmap 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 pixel para o bitmap de máscara especificado pelo parâmetro maskBitmap.

yMask

Especifica o deslocamento vertical pixel para o bitmap de máscara especificado pelo parâmetro maskBitmap.

dwRop

Especifica os primeiro plano e segundo plano códigos de operação de varredura Ternário, usa a função para controle a combinação de dados de origem e de destino. Código de operação de varredura segundo plano é armazenado no byte alto da palavra alta desse valor; o código de operação de varredura primeiro plano é armazenado no byte baixo da palavra alta desse valor; a palavra baixa desse valor é ignorada e deve ser zero. A macro MAKEROP4 cria essas combinações de primeiro plano e segundo plano códigos operação de varredura. Consulte a seção de comentários para uma discussão de primeiro plano e segundo plano no contexto desta função. Consulte a BitBlt função de membro para obter uma lista de comum códigos operação de varredura.

Observações

Combina dados de cor para os bitmaps origem e destino usando a máscara específica e a operação de varredura. Um valor de 1 na máscara especificada por maskBitmap indica que a codificar operação de varredura primeiro plano especificado por dwRop deve ser aplicada dessa localidade. Um valor de 0 na máscara indica que a codificar operação de varredura segundo plano especificado por dwRop deve ser aplicada dessa localidade. Se as operações de varredura exigem uma origem, o retângulo máscara deve rosto retângulo de origem. Se não existir, a função falhará. Se as operações de varredura não necessitam de uma fonte, o retângulo máscara deve rosto retângulo de destino. Se não existir, a função irá falhar.

Se uma transformação de rotação ou distorcer estiver aplicado para o contexto dispositivo origem quando essa função é chamada, ocorrerá um erro. No entanto, outros tipos de transformações são permitidos.

Se os formatos cor da fonte, padrão e bitmaps destino forem diferentes, essa função converte o padrão ou formato de fonte ou ambos, para corresponder ao 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 retorna 0) se o contexto dispositivo origem identifica um avançado contexto dispositivo metarquivo. Nem todos os dispositivos suportam a 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 se comporta exatamente como BitBlt, usando o código de operação de varredura primeiro plano. O pixel desloca no mapa do bitmap de máscara para o ponto (0,0) no bitmap do contexto de dispositivo origem. Isso é útil para casos em que um bitmap de máscara contém um conjunto de máscaras; um aplicativo pode facilmente aplicar qualquer um para uma tarefa de máscara-blitting ajustando o pixel deslocamentos e tamanhos de retângulo enviados a MaskBlt.

Visão geral do CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC:: BitBlt, CDC:: GetDeviceCaps, CDC::PlgBlt, CDC:: StretchBlt, :: MaskBlt

Index