Bitmap.Clone Method (Rectangle, PixelFormat)
Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- rect
-
Type:
System.Drawing.Rectangle
Defines the portion of this Bitmap to copy. Coordinates are relative to this Bitmap.
- format
-
Type:
System.Drawing.Imaging.PixelFormat
The pixel format for the new Bitmap. This must specify a value that begins with Format.
| Exception | Condition |
|---|---|
| OutOfMemoryException | rect is outside of the source bitmap bounds. |
| ArgumentException | The height or width of rect is 0. -or- A PixelFormat value is specified whose name does not start with Format. For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not. |
The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:
Creates a Bitmap from a file.
Clones a portion of that Bitmap.
Draws the cloned portion to the screen.
private void Clone_Example1(PaintEventArgs e) { // Create a Bitmap object from a file. Bitmap myBitmap = new Bitmap("Grapes.jpg"); // Clone a portion of the Bitmap object. Rectangle cloneRect = new Rectangle(0, 0, 100, 100); System.Drawing.Imaging.PixelFormat format = myBitmap.PixelFormat; Bitmap cloneBitmap = myBitmap.Clone(cloneRect, format); // Draw the cloned portion of the Bitmap object. e.Graphics.DrawImage(cloneBitmap, 0, 0); }
Available since 1.1