CImage::StretchBlt

Copies a bitmap from the source device context to this current device context.

BOOL StretchBlt( 
   HDC hDestDC, 
   int xDest, 
   int yDest, 
   int nDestWidth, 
   int nDestHeight, 
   DWORD dwROP = SRCCOPY  
) const throw( ); 
BOOL StretchBlt( 
   HDC hDestDC, 
   const RECT& rectDest, 
   DWORD dwROP = SRCCOPY  
) const throw( ); 
BOOL StretchBlt( 
   HDC hDestDC, 
   int xDest, 
   int yDest, 
   int nDestWidth, 
   int nDestHeight, 
   int xSrc, 
   int ySrc, 
   int nSrcWidth, 
   int nSrcHeight, 
   DWORD dwROP = SRCCOPY  
) const throw( ); 
BOOL StretchBlt( 
   HDC hDestDC, 
   const RECT& rectDest, 
   const RECT& rectSrc, 
   DWORD dwROP = SRCCOPY  
) const throw( );

Parameters

  • hDestDC
    A handle to the destination device context.

  • xDest
    The x-coordinate, in logical units, of the upper left corner of the destination rectangle.

  • yDest
    The y-coordinate, in logical units, of the upper left corner of the destination rectangle.

  • nDestWidth
    The width, in logical units, of the destination rectangle.

  • nDestHeight
    The height, in logical units, of the destination rectangle.

  • dwROP
    The raster operation to be performed. Raster-operation codes define exactly how to combine the bits of the source, the destination, and the pattern (as defined by the currently selected brush) to form the destination. See BitBlt in the Windows SDK for a list of other raster-operation codes and their descriptions.

  • rectDest
    A reference to a RECT structure, identifying the destination.

  • xSrc
    The x-coordinate, in logical units, of the upper left corner of the source rectangle.

  • ySrc
    The y-coordinate, in logical units, of the upper left corner of the source rectangle.

  • nSrcWidth
    The width, in logical units, of the source rectangle.

  • nSrcHeight
    The height, in logical units, of the source rectangle.

  • rectSrc
    A reference to a RECT structure, identifying the source.

Return Value

Nonzero if successful, otherwise 0.

Remarks

For more information, see StretchBlt in the Windows SDK.

Requirements

Header: atlimage.h

See Also

Reference

CImage Class

CImage::BitBlt

CImage::MaskBlt

Other Resources

CImage Members