MaskBlt
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função combina dados de cor para os bitmaps origem e destino usando a máscara especificada e operação de varredura.
Syntax
BOOL MaskBlt(
HDC hdcDest,
int nXDest,
int nYDest,
int nWidth,
int nHeight,
HDC hdcSrc,
int nXSrc,
int nYSrc,
HBITMAP hbmMask,
int xMask,
int yMask,
DWORD dwRop
);
Parameters
- hdcDest
[no] Identificador para o contexto dispositivo destino.
- nXDest
[no] Especifica o x lógica-coordenar do canto superior esquerdo do retângulo de destino.
- nYDest
[no] Especifica a y lógica-coordenar do canto superior esquerdo do retângulo de destino.
- nWidth
[no] Especifica a largura, em unidades lógicas, de bitmap retângulo e origem de destino.
- nHeight
[no] Especifica a altura, em unidades lógicas, de bitmap retângulo e origem de destino.
- hdcSrc
[no] Identificador para o contexto dispositivo a partir da qual o bitmap é a serem copiados. Ele deve ser zero se a dwRop parâmetro especifica uma operação de varredura que não inclui uma origem.
- nXSrc
[no] Especifica o x lógica-coordenar do canto superior esquerdo do bitmap de origem.
- nYSrc
[no] Especifica a y lógica-coordenar do canto superior esquerdo do bitmap de origem.
- hbmMask
[no] Identificador para o monocromático bitmap máscara combinado com o bitmap cor no contexto de dispositivo origem.
- xMask
[no] Especifica o deslocamento horizontal pixel para o bitmap máscara especificada pelo hbmMask parâmetro.
- yMask
[no] Especifica o deslocamento vertical pixel para o bitmap máscara especificada pelo hbmMask parâmetro.
dwRop
[no] Especifica os primeiro plano e segundo plano operação de varredura Ternário códigos que usa a função para controle a combinação de origem e destino dados.Codificar operação de varredura o segundo plano é armazenado de alta - byte ordem o alto - palavra ordem desse valor. Codificar operação de varredura o primeiro plano é armazenada no - byte ordem de alta - baixa ordem palavra desse valor; a baixa-ordem palavra desse valor é ignorada e deve ser zero.
A macro MAKEROP4 Cria essas combinações de códigos operação de varredura primeiro plano e segundo plano.
Para uma discussão de primeiro plano e segundo plano no contexto desta função, consulte a seguinte seção Comentários.
Para uma lista de comum códigos operação de varredura, consulte o BitBlt função.
Windows CE 1.0 e 1.01 suporte somente a SRCCOPY e SRCINVERT Operações de varredura.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
Um valor de 1 in a máscara especificada por hbmMask Indica que a codificar operação de varredura primeiro plano especificado por dwRop deve ser aplicada dessa localidade.
Um valor de 0 a 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 ele não, a função falhará.
Se as operações de varredura não exigem uma origem, o retângulo máscara deve rosto retângulo de destino. Se ele não, a função falhará.
Se uma transformação de rotação ou distorcer estiver aplicado para o contexto dispositivo origem quando esta função é chamado, um erro ocorre. No entanto, outros tipos de transformação são permitidos.
Se os formatos cor da origem, padrão e bitmaps destino forem diferentes, essa função converte o padrão ou formato origem ou ambos, para coincidir com o formato destino.
Se o bitmap máscara não for um bitmap monocromático, ocorrerá um erro.
Quando um metarquivo avançado está sendo gravada, ocorrerá um erro (e a função retorna FALSE) se o contexto dispositivo origem identifica um avançado-contexto dispositivo metarquivo.
Nem todos os dispositivos suporte a MaskBlt função. Um aplicativo deve chamar o GetDeviceCaps função 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 a codificar operação de varredura primeiro plano.
Requirements
| Header | windows.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |