CImage::TransparentBlt

Copia un mapa de bits de contexto del dispositivo de origen a este contexto actual del dispositivo.

BOOL TransparentBlt(
   HDC hDestDC,
   int xDest,
   int yDest,
   int nDestWidth,
   int nDestHeight,
   UINT crTransparent = CLR_INVALID 
) const throw( );
BOOL TransparentBlt(
   HDC hDestDC,
   const RECT& rectDest,
   UINT crTransparent = CLR_INVALID 
) const throw( );
BOOL TransparentBlt(
   HDC hDestDC,
   int xDest,
   int yDest,
   int nDestWidth,
   int nDestHeight,
   int xSrc,
   int ySrc,
   int nSrcWidth,
   int nSrcHeight,
   UINT crTransparent = CLR_INVALID 
) const throw( );
BOOL TransparentBlt(
   HDC hDestDC,
   const RECT& rectDest,
   const RECT& rectSrc,
   UINT crTransparent = CLR_INVALID 
) const throw( );

Parámetros

  • hDestDC
    Un identificador al contexto del dispositivo de destino.

  • xDest
    La coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

  • yDest
    La coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

  • nDestWidth
    El ancho, en unidades lógicas, el rectángulo de destino.

  • nDestHeight
    El alto, en unidades lógicas, el rectángulo de destino.

  • crTransparent
    Color del mapa de bits de origen a tratar como transparente.De forma predeterminada, CLR_INVALID, que indica que un color establecido actualmente como color transparente en la imagen se debe utilizar.

  • rectDest
    Una referencia a una estructura de RECT , identifica el destino.

  • xSrc
    La coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

  • ySrc
    La coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

  • nSrcWidth
    El ancho, en unidades lógicas, el rectángulo de origen.

  • nSrcHeight
    El alto, en unidades lógicas, el rectángulo de origen.

  • rectSrc
    Una referencia a una estructura de RECT , identifica el origen.

Valor devuelto

TRUE si es correcto, si no FALSE.

Comentarios

TransparentBlt se admite para los mapas de bits del origen de 4 bits por píxel y de 8 bits por píxel.Utilice CImage::AlphaBlend para especificar 32 mapas de bits de bits por píxel con la transparencia.

Este método es aplicable a Microsoft Windows 2000, a Windows 98, y a sistemas posteriores.Vea TransparentBlt en Windows SDK y CImage Limitaciones con sistemas operativos anteriores para obtener información detallada.

Ejemplo

// Performs a transparent blit from the source image to the destination 
// image using the images' current transparency settings
BOOL TransparentBlt(CImage* pSrcImage, CImage* pDstImage, int xDest, int yDest,
   int nDestWidth, int nDestHeight)
{
   HDC hDstDC = NULL;
   BOOL bResult;

   if(pSrcImage == NULL || pDstImage == NULL)
   {
      // Invalid parameter
      return FALSE;
   }

   // Obtain a DC to the destination image
   hDstDC = pDstImage->GetDC();

   // Perform the blit
   bResult = pSrcImage->TransparentBlt(hDstDC, xDest, yDest, nDestWidth, nDestHeight);

   // Release the destination DC
   pDstImage->ReleaseDC();

   return bResult;
}

Requisitos

encabezado: atlimage.h

Vea también

Referencia

Clase CImage

CImage::StretchBlt

CImage::MaskBlt

CImage::BitBlt