This function performs a bit-block transfer of the color data corresponding to a rectangle of pixels from the specified source device context into a destination device context.
[C++Builder] BOOL
IKBitBlt(HDC hDCDst, long XDst, long YDst, long Width, long Height,
HDC hDCSrc, long XSrc, long YSrc, DWORD dwRop);
[Delphi] function
IKBitBlt(hDCDst: HDC; XDst, YDst, Width, Height: Longint; hDCSrc:
HDC; XSrc, YSrc: Longint; dwRop: DWORD): LongBool;
Parameters
| Name | Explanation |
|---|---|
| hDCDst | handle to destination device context |
| XDst | x-coordinate of destination upper-left corner (in pixels) |
| YDst | y-coordinate of destination upper-left corner (in pixels) |
| Width | width of destination rectangle (in pixels) |
| Height | height of destination rectangle (in pixels) |
| hDCSrc | handle to source device context |
| XSrc | x-coordinate of source upper-left corner (in pixels) |
| YSrc | y-coordinate of source upper-left corner (in pixels) |
| dwRop | raster operation code |
Return Value
Returns True if successful, returns False when unsuccessful
Explanation
The following list shows the raster operation codes.
| 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) |
The above hexidecimal notation uses Delphi's 0x. The terms within the parentheses () refer to the Windows API operation.