CImage::PlgBlt

Artigo
08/25/2010

Executa uma transferência de blocos de bit de um retângulo em um contexto de dispositivo de fonte em um paralelogramo em um contexto de dispositivo de destino.

BOOL PlgBlt(
   HDC hDestDC,
   const POINT* pPoints,
   HBITMAP hbmMask = NULL 
) const throw( );
BOOL PlgBlt(
   HDC hDestDC,
   const POINT* pPoints,
   int xSrc,
   int ySrc,
   int nSrcWidth,
   int nSrcHeight,
   HBITMAP hbmMask = NULL,
   int xMask = 0,
   int yMask = 0 
) const throw( );
BOOL PlgBlt(
   HDC hDestDC,
   const POINT* pPoints,
   const RECT& rectSrc,
   HBITMAP hbmMask = NULL,
   const POINT& pointMask = CPoint(
   0, 0 ) 
) const throw( );

Parâmetros

hDestDC
Um identificador para o contexto de dispositivo de destino.
pPoints
Um ponteiro para uma matriz de três pontos espaço lógico que identificam os três vértices de paralelograma destino.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.
hbmMask
Um identificador para um bitmap monocromáticas opcional usada para as cores do retângulo de fonte de máscara.
xSrc
A coordenada x, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.
ySrc
A coordenada y, em unidades lógicas, do canto superior esquerdo do retângulo de fonte.
nSrcWidth
A largura, em unidades lógicas, do retângulo de fonte.
nSrcHeight
A altura, em unidades lógicas, do retângulo de fonte.
xMask
A coordenada x do canto superior esquerdo do bitmap monocromático.
yMask
A coordenada y do canto superior esquerdo do bitmap monocromático.
rectSrc
Uma referência a um RECT estrutura especificando as coordenadas do retângulo de fonte.
pointMask
A PONTO estrutura indicando que o canto superior esquerdo da máscara de bitmap.

Valor de retorno

Diferente de zero se for bem-sucedido, caso contrário, 0.

Comentários

If hbmMask identifica um bitmap monocromático válido, PlgBit usa este bitmap para mascarar os bits de dados de cores do retângulo de fonte.

Este método se aplica ao Windows NT, as versões 4.0 e posterior apenas.See PlgBlt in the Windows SDK e Limitações de CImage com sistemas operacionais anteriores para obter informações mais detalhadas.