Copy(Graphics,Rectangle,Point) メソッド

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.

シンタックス

Visual Basic
C#

'宣言
 
Public Overloads Sub Copy( _
   ByVal graphics As Graphics, _
   ByVal destRectangle As System.Drawing.Rectangle, _
   ByVal srcPoint As System.Drawing.Point _
)

public void Copy( 
   Graphics graphics,
   System.Drawing.Rectangle destRectangle,
   System.Drawing.Point srcPoint
)

パラメータ

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.

例外

例外	解説
C1.Framework.SystemErrorException	Defines an exception class to handle the system error.

解説

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.

参照

Graphics クラス
 Graphics メンバ
 オーバーロード一覧