Bitmap::Clone Method (RectangleF, PixelFormat)
.NET Framework (current version)
Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.
Assembly: System.Drawing (in System.Drawing.dll)
Parameters
- rect
-
Type:
System.Drawing::RectangleF
Defines the portion of this Bitmap to copy.
- format
-
Type:
System.Drawing.Imaging::PixelFormat
Specifies the PixelFormat enumeration for the destination Bitmap.
| Exception | Condition |
|---|---|
| OutOfMemoryException | rect is outside of the source bitmap bounds. |
| ArgumentException | The height or width of rect is 0. |
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_Example2( PaintEventArgs^ e ) { // Create a Bitmap object from a file. Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" ); // Clone a portion of the Bitmap object. RectangleF cloneRect = RectangleF(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 ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: