A | B | C |  D | E | F |  G | H | I |  J | K | L |  M | N | O |  P | Q | R |  S | T | U |  V | W | X |  Y | Z



StretchBlt

The StretchBlt function copies a bitmap from a source rectangle into a destination rectangle, stretching or compressing the bitmap to fit the dimensions of the destination rectangle, if necessary. Windows stretches or compresses the bitmap according to the stretching mode currently set in the destination device context.

VB4-32,5,6
Declare Function StretchBlt Lib "gdi32" Alias "StretchBlt" (ByVal hdc As Long, ByVal x As Long, ByVal y As Long, ByVal nWidth As Long, ByVal nHeight As Long, ByVal hSrcDC As Long, ByVal xSrc As Long, ByVal ySrc As Long, ByVal nSrcWidth As Long, ByVal nSrcHeight As Long, ByVal dwRop As Long) As Long

VB.NET
System.Drawing.Graphics.DrawImage

Operating Systems Supported
Requires Windows NT 3.1 or later; Requires Windows 95 or later

Library
Gdi32

Parameter Information
- hdcDest
Identifies the destination device context.

- nXOriginDest
Specifies the x-coordinate, in logical units, of the upper-left corner of the destination rectangle.

- nYOriginDest
Specifies the y-coordinate, in logical units, of the upper-left corner of the destination rectangle.

- nWidthDest
Specifies the width, in logical units, of the destination rectangle.

- nHeightDest
Specifies the height, in logical units, of the destination rectangle.

- hdcSrc
Identifies the source device context.

- nXOriginSrc
Specifies the x-coordinate, in logical units, of the upper-left corner of the source rectangle.

- nYOriginSrc
Specifies the y-coordinate, in logical units, of the upper-left corner of the source rectangle.

- nWidthSrc
Specifies the width, in logical units, of the source rectangle.

- nHeightSrc
Specifies the height, in logical units, of the source rectangle.

- dwRop
Specifies the raster operation to be performed. Raster operation codes define how Windows combines colors in output operations that involve a brush, a source bitmap, and a destination bitmap.
See the BitBlt function for a list of common raster operation codes.

Return Values
If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Last update: 07 April 2006