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 Sub Clone_Example2(ByVal e As PaintEventArgs) ' Create a Bitmap object from a file. Dim myBitmap As New Bitmap("Grapes.jpg") ' Clone a portion of the Bitmap object. Dim cloneRect As New RectangleF(0, 0, 100, 100) Dim format As PixelFormat = myBitmap.PixelFormat Dim cloneBitmap As Bitmap = myBitmap.Clone(cloneRect, format) ' Draw the cloned portion of the Bitmap object. e.Graphics.DrawImage(cloneBitmap, 0, 0) End Sub
.NET Framework
Available since 1.1
Available since 1.1
Show: