第1个回答 2012-01-27
specified source device context into a destination device context.
Syntax
Parameters
hdcDest [in]
A handle to the destination device context.
nXDest [in]
The x-coordinate, in logical units, of the upper-left corner of the destination rectangle.
nYDest [in]
The y-coordinate, in logical units, of the upper-left corner of the destination rectangle.
nWidth [in]
The width, in logical units, of the source and destination rectangles.
nHeight [in]
The height, in logical units, of the source and the destination rectangles.
hdcSrc [in]
A handle to the source device context.
nXSrc [in]
The x-coordinate, in logical units, of the upper-left corner of the source rectangle.
nYSrc [in]
The y-coordinate, in logical units, of the upper-left corner of the source rectangle.
dwRop [in]
A raster-operation code. These codes define how the color data for the source rectangle is to be combined with the color data for the destination rectangle to achieve the final color. The following list shows some common raster operation codes.
Value Meaning
BLACKNESS
CAPTUREBLT
DSTINVERT
MERGECOPY
MERGEPAINT
NOMIRRORBITMAP
NOTSRCCOPY
NOTSRCERASE
PATCOPY
PATINVERT
PATPAINT
SRCAND
SRCCOPY
SRCERASE
SRCINVERT
SRCPAINT
WHITENESS
Return value
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.
Remarks
BitBlt only does clipping on the destination DC. If a rotation or shear transformation is in effect in the source device context, BitBlt returns an error. If other transformations exist in the source device context (and a matching transformation is not in effect in the destination device context), the rectangle in the destination device context is stretched, compressed, or rotated, as necessary. If the color formats of the source and destination device contexts do not match, the BitBlt function converts the source color format to match the destination format. When an enhanced metafile is being recorded, an error occurs if the source device context identifies an enhanced-metafile device context. Not all devices support the BitBlt function. For more information, see the RC_BITBLT raster capability entry in the GetDeviceCaps function as well as the following functions: MaskBlt, PlgBlt, and StretchBlt. BitBlt returns an error if the source and destination device contexts represent different devices. To transfer data between DCs for different devices, convert the memory bitmap to a DIB by calling GetDIBits. To display the DIB to the second device, call SetDIBits or StretchDIBits. ICM: No color management is performed when blits occur.
Examples
For an example, see Capturing an Image.
Requirements
Minimum supported client Windows 2000 Professional
Minimum supported server Windows 2000 Server
Header Wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll
See also
Bitmaps Overview Bitmap Functions GetDeviceCaps GetDIBits MaskBlt PlgBlt SetDIBits StretchBlt StretchDIBits