CDC::PlgBlt

BOOL PlgBlt ( ponto lpPoint, CDC * pSrcDC, int xSrc, int ySrc, int nWidth, int nHeight, CBitm&apamp; maskBitmap, int xMask, int yMask );

Valor de retorno

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

Parâmetros

lpPoint

Aponta para uma matriz de três pontos no espaço lógico que identifica três cantos do paralelogramo destino. O canto superior esquerdo do retângulo de origem é mapeado para o primeiro ponto desta matriz, o canto superior direito para o segundo ponto nessa matriz e inferior-esquerda canto para o terceiro ponto. Parte inferior-direito canto do retângulo de origem é mapeado para o ponto de quarto implícito no paralelogramo.

pSrcDC

Identifica o contexto de dispositivo de origem.

xSrc

Especifica o x-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

ySrc

Especifica a y-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

nWidth

Especifica a largura, em unidades lógicas, do retângulo de origem.

nHeight

Especifica a altura, em unidades lógicas, do retângulo de origem.

maskBitmap

Identifica um bitmap monocromático opcional que é usado para mascarar as cores do retângulo de origem.

xMask

Especifica o x-coordenar de upper-Esquerda canto do bitmap monocromático.

yMask

Especifica a y-coordenar de upper-Esquerda canto do bitmap monocromático.

Observações

Executa um bit transferir bloco de bits de dados de cores do Retangular especificado no contexto de dispositivo de origem para o paralelogramo especificado no contexto de determinado dispositivo. Se o identificador de bitmask determinado identifica um bitmap monocromático válido, a função usa este bitmap para mascarar os bits de dados de cores do Retangular de origem.

O vértice quarto do paralelogramo (D) é definido por tratar os primeiros três pontos (A, B e C) como vetores e computação D = B + C - A.

Se a máscara de bits existir, um valor de 1 na máscara indica que a cor do pixel origem deve ser copiada para o destino. Um valor de 0 na máscara indica que a cor do pixel de destino não é devem ser alterados.

Se o retângulo máscara for menor que os retângulos origem e destino, a função replica o padrão de máscara.

Dimensionamento, tradução e reflexão transformações são permitidas no contexto de dispositivo de origem; no entanto, transformações de rotação e shear não são. Se o bitmap de máscara não for um bitmap monocromático, ocorrerá um erro. O modo stretching para o contexto de dispositivo de destino é usado para determinar como alongar ou compactar os pixels, se tal for necessário. Quando um metarquivo avançado está sendo gravado, ocorrerá um erro se o contexto dispositivo origem identifica um avançado contexto dispositivo metarquivo.

As coordenadas de destino são transformadas de acordo com o contexto de dispositivo de destino; as coordenadas de origem são transformadas de acordo com o contexto dispositivo origem. Se a transformação de origem tiver uma rotação ou distorcer, um erro será retornado. Se os retângulos de origem e de destino não tiver o mesmo formato cor, PlgBlt converte o Retangular de origem para coincidir com o Retangular de destino. Nem Tudo dispositivos suportam PlgBlt. Para obter mais informações, consulte a descrição de varredura RC_BITBLT na função de membro CDC:: GetDeviceCaps .

Se a origem e destino contextos dispositivo representam dispositivos incompatíveis, PlgBlt retornará um erro.

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

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

Index