CDC::PlgBlt

Executa uma transferência de blocos de bit dos bit de dados de cores do retângulo especificado no contexto de dispositivo de fonte para o paralelogramo especificado no contexto de dispositivo especificado.

BOOL PlgBlt(
   LPPOINT lpPoint,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   int nWidth,
   int nHeight,
   CBitmap& maskBitmap,
   int xMask,
   int yMask 
);

Parâmetros

lpPoint
Aponta para uma matriz de três pontos no espaço lógico que identifica os três vértices de paralelograma destino.O canto superior esquerdo do retângulo de fonte é mapeado para o primeiro ponto nessa matriz, o canto superior direito para o segundo ponto nessa matriz e o canto inferior esquerdo para o terceiro ponto.O canto inferior direito do retângulo de fonte é mapeado para o ponto de quarto implícito do paralelogramo.
pSrcDC
Identifica o contexto de dispositivo de fonte.
xSrc
Especifica a coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.
ySrc
Especifica a coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.
nWidth
Especifica a largura, em unidades lógicas, do retângulo de fonte.
nHeight
Especifica a altura, em unidades lógicas, do retângulo de fonte.
maskBitmap
Identifica um recurso opcional monocromático bitmap é usado para as cores do retângulo de fonte de máscara.
xMask
Especifica a coordenada x do canto superior esquerdo do monocromático bitmap.
yMask
Especifica a coordenada y do canto superior esquerdo do monocromático bitmap.

Valor de retorno

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

Comentários

Se o identificador de bitmask determinado identifica válido monocromático bitmap, a função usa este bitmap para mascarar os bits de dados de cores do retângulo de fonte.

O quarto vértice do paralelogramo (D) é definido por tratando sistema autônomo primeiros três pontos (A, B e C) sistema autônomo vetores e computação D = B + C - a.

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

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

Transformações de dimensionamento, conversão e reflexão podem no contexto de dispositivo de fonte; no entanto, rotação e distorção transformações não são.Se a máscara de bitmap não for um bitmap monocromáticas, ocorrerá um erro.O modo de alongamento para o contexto de dispositivo de destino é usado para determinar como esticar ou compactar os pixels, se for necessário.Quando um metarquivo avançado está sendo gravado, ocorrerá um erro se o contexto de dispositivo de fonte identifica um contexto de dispositivo de metarquivo aprimorado.

As coordenadas de destino são transformadas de acordo com para o contexto de dispositivo de destino; as coordenadas de fonte são transformadas de acordo com para o contexto de dispositivo de fonte.Se a transformação de fonte tiver uma rotação ou distorção, será retornado um erro.Se os retângulos de fonte e destino não tem o mesmo formato de cor, PlgBlt Converte o retângulo de fonte para coincidir com o retângulo de destino. Nem todos os dispositivos oferecem suporte a PlgBlt. Para obter mais informações, consulte a descrição do RC_BITBLT raster capacidade no CDC::GetDeviceCaps função de membro.

Se os contextos de dispositivo de fonte e destino representam dispositivos incompatíveis, PlgBlt Retorna um erro.