ComponentOne MultiSelect for WinForms
C1.Framework.Drawing.Gdi.DeviceContexts Namespace / DeviceContext Class / Copy Method / Copy(DeviceContext,Rectangle,Point,RasterOperationCode) Method
The source DeviceContext object.
A System.Drawing.Rectangle indicates the destination rectangle.
A System.Drawing.Point indicates the upper-left corner of source rectangle. The width and height of source rectangle are same as the destination rectangle.
A DeviceContext.RasterOperationCode indicates the raster operation code.

In This Topic
    Copy(DeviceContext,Rectangle,Point,RasterOperationCode) Method
    In This Topic
    Performs a bit-block transfer of the color data corresponding to a rectangle of pixels from the specified source DeviceContext object into a destination DeviceContext object.
    Syntax
    'Declaration
     
    
    Public Overloads Overridable Sub Copy( _
       ByVal deviceContext As DeviceContext, _
       ByVal destRectangle As Rectangle, _
       ByVal srcPoint As Point, _
       ByVal rop As RasterOperationCode _
    ) 

    Parameters

    deviceContext
    The source DeviceContext object.
    destRectangle
    A System.Drawing.Rectangle indicates the destination rectangle.
    srcPoint
    A System.Drawing.Point indicates the upper-left corner of source rectangle. The width and height of source rectangle are same as the destination rectangle.
    rop
    A DeviceContext.RasterOperationCode indicates the raster operation code.
    Exceptions
    ExceptionDescription
    Defines an exception class to handle the system error.
    Remarks

    Copy only does clipping on the destination DC.

    If a rotation or shear transformation is in effect in the source device context, Copy will throw a C1.Framework.SystemErrorException. 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 Copy 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. it means a C1.Framework.SystemErrorException would be throw out.

    Not all devices support the Copy function. For more information, see the RC_BITBLT raster capability entry in the GetDeviceCaps function as well as the following: MaskBlt, PlgBlt, and StretchBlt.

    See Also