The StretchBlt method 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.
Parameters
| Name | Explanation |
|---|---|
| DCDst | handle to destination DC |
| XDst | x-coord of destination upper-left corner |
| YDst | y-coord of destination upper-left corner |
| WidthDst | width of destination rectangle |
| HeightDst | height of destination rectangle |
| DCSrc | handle to source DC |
| XSrc | x-coord of source upper-left corner |
| YSrc | y-coord of source upper-left corner |
| WidthSrc | width of source rectangle |
| HeightSrc | height of source rectangle |
| dwRop | raster operation code |
Return Value
Returns True if successful, otherwise returns False.
Explanation
The StretchBlt method 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.
The StretchBlt method creates a mirror image of a bitmap if the signs of the WidthSrc and WidthDest parameters or if the HeightSrc and HeightDest parameters differ. If WidthSrc and WidthDest have different signs, the function creates a mirror image of the bitmap along the x-axis. If HeightSrc and HeightDest have different signs, the function creates a mirror image of the bitmap along the y-axis.
| Value | Explanation |
|---|---|
| 0x00000042 | Fills the destination rectangle using the color associated with index 0 in the physical palette. (This color is black for the default physical palette.)(BLACKNESS) |
| 0x00550009 | Inverts the destination rectangle.(DSTINVERT) |
| 0x00C000CA | Merges the colors of the source rectangle with the brush currently selected in hdcDest, by using the Boolean AND operator.(MERGECOPY) |
| 0x00BB0226 | Merges the colors of the inverted source rectangle with the colors of the destination rectangle by using the Boolean OR operator.(MERGEPAINT) |
| 0x00330008 | Copies the inverted source rectangle to the destination.(NOTSRCCOPY) |
| 0x001100A6 | Combines the colors of the source and destination rectangles by using the Boolean OR operator and then inverts the resultant color.(NOTSRCERASE) |
| 0x00F00021 | Copies the brush currently selected in hdcDest, into the destination bitmap.(PATCOPY) |
| 0x005A0049 | Combines the colors of the brush currently selected in hdcDest, with the colors of the destination rectangle by using the Boolean XOR operator.(PATINVERT) |
| 0x00FB0A09 | Combines the colors of the brush currently selected in hdcDest, with the colors of the inverted source rectangle by using the Boolean OR operator. The result of this operation is combined with the colors of the destination rectangle by using the Boolean OR operator.(PATPAINT) |
| 0x008800C6 | Combines the colors of the source and destination rectangles by using the Boolean AND operator.(SRCAND) |
| 0x00CC0020 | Copies the source rectangle directly to the destination rectangle.(SRCCOPY) |
| 0x00440328 | Combines the inverted colors of the destination rectangle with the colors of the source rectangle by using the Boolean AND operator.(SRCERASE) |
| 0x00660046 | Combines the colors of the source and destination rectangles by using the Boolean XOR operator.(SRCINVERT) |
| 0x00EE0086 | Combines the colors of the source and destination rectangles by using the Boolean OR operator.(SRCPAINT) |
| 0x00FF0062 | Fills the destination rectangle using the color associated with index 1 in the physical palette. (This color is white for the default physical palette.)(WHITENESS) |
Ordinarily, the value 0x00CC0020(SRCCOPY) is used.
When using hexidecimals in Delphi change the 0x notation to $
The terms within the parentheses () refer to the Windows API operation.