ComponentOne MultiSelect for WinForms
C1.Framework.Drawing.Gdi Namespace / Graphics Class / Copy Method / Copy(Graphics,Rectangle,Point) Method
A Graphics indicate the source Graphics 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.

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

    Parameters

    graphics
    A Graphics indicate the source Graphics 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.
    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