Partilhar via


CImage::PlgBlt

Executa uma transferência de bits bloco de um retângulo em um contexto de dispositivo fonte em um paralelogramo em um contexto do 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 do dispositivo de destino.

  • pPoints
    Um ponteiro para uma matriz de três pontos no espaço de lógica que identificam três cantos de paralelogramo de destino.O canto superior esquerdo do retângulo de origem é mapeado para o primeiro ponto em esta matriz, ao canto superior direito para o segundo ponto em esta matriz, e ao canto inferior esquerdo para o terceiro ponto.O canto inferior direito do retângulo de origem é mapeado para o quarto ponto no paralelogramo implícito.

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

  • xSrc
    A coordenada x, em unidades lógicas, o canto superior esquerdo do retângulo de origem.

  • ySrc
    A coordenada y, em unidades lógicas, o canto superior esquerdo do retângulo de origem.

  • nSrcWidth
    A largura, em unidades lógicas, o retângulo de origem.

  • nSrcHeight
    A altura, em unidades lógicas, o retângulo de origem.

  • xMask
    A coordenada x do canto superior esquerdo de bitmap monocromático.

  • yMask
    A coordenada y do canto superior esquerdo de bitmap monocromático.

  • rectSrc
    Uma referência a uma estrutura de RECT que especifica as coordenadas do retângulo de origem.

  • pointMask
    Uma estrutura de PONTO que indica o canto superior esquerdo do bitmap de máscara.

Valor de retorno

Diferente de zero se com êxito, se não 0.

Comentários

Se hbmMask identifica um bitmap monocromático válido, PlgBit usa esse bitmap para mascarar os bits de dados de cor do retângulo de origem.

Este método se aplica a, Windows NT 4,0 e versões posteriores somente.Consulte PlgBlt em Windows SDK e Limitações de CImage com sistemas operacionais anteriores para informações mais detalhadas.

Requisitos

Cabeçalho: atlimage.h

Consulte também

Referência

Classe de CImage

CImage::BitBlt

CImage::MaskBlt