Bitmap.Clone Method

Définition

Crée une copie d'une section de ce Bitmap définie à l'aide d'un PixelFormat spécifié. Creates a copy of the section of this Bitmap defined with a specified PixelFormat.

Surcharges

Clone(RectangleF, PixelFormat)

Crée une copie d'une section de ce Bitmap définie à l'aide d'une énumération PixelFormat spécifiée. Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

Clone(Rectangle, PixelFormat)

Crée une copie de la section de ce Bitmap définie par la structure Rectangle, avec une énumération PixelFormat spécifiée. Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

Crée une copie d'une section de ce Bitmap définie à l'aide d'une énumération PixelFormat spécifiée. Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

public System.Drawing.Bitmap Clone (System.Drawing.RectangleF rect, System.Drawing.Imaging.PixelFormat format);
Paramètres
rect
RectangleF

Définit la partie de ce Bitmap à copier. Defines the portion of this Bitmap to copy.

format
PixelFormat

Spécifie l'énumération PixelFormat pour le Bitmap de destination. Specifies the PixelFormat enumeration for the destination Bitmap.

Retours

Bitmap créé par cette méthode. The Bitmap that this method creates.

Exceptions

rect est en dehors des limites de la bitmap source. rect is outside of the source bitmap bounds.

La hauteur ou la largeur de rect est 0. The height or width of rect is 0.

Exemples

L’exemple de code suivant est conçu pour une utilisation avec Windows Forms et nécessite PaintEventArgs e, qui est un paramètre de la Paint Gestionnaire d’événements.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Le code exécute les actions suivantes :The code performs the following actions:

  • Crée un Bitmap à partir d’un fichier.Creates a Bitmap from a file.

  • Clone une partie de ce Bitmap.Clones a portion of that Bitmap.

  • Dessine la partie clonée à l’écran.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 );
   }
private void Clone_Example2(PaintEventArgs e)
{

    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");

    // Clone a portion of the Bitmap object.
    RectangleF cloneRect = new 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);
}
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

Clone(Rectangle, PixelFormat)

Crée une copie de la section de ce Bitmap définie par la structure Rectangle, avec une énumération PixelFormat spécifiée. Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

public System.Drawing.Bitmap Clone (System.Drawing.Rectangle rect, System.Drawing.Imaging.PixelFormat format);
Paramètres
rect
Rectangle

Définit la partie de ce Bitmap à copier. Defines the portion of this Bitmap to copy. Les coordonnées sont relatives à ce Bitmap. Coordinates are relative to this Bitmap.

format
PixelFormat

Format de pixel du nouveau Bitmap. The pixel format for the new Bitmap. Une valeur commençant par Format doit être spécifiée. This must specify a value that begins with Format.

Retours

Nouveau Bitmap créé par cette méthode. The new Bitmap that this method creates.

Exceptions

rect est en dehors des limites de la bitmap source. rect is outside of the source bitmap bounds.

La hauteur ou la largeur de rect est 0. The height or width of rect is 0. - ou - -or- Une valeur PixelFormat dont le nom ne commence pas par Format est spécifiée. A PixelFormat value is specified whose name does not start with Format. Par exemple, Gdi provoquera une ArgumentException, mais pas Format48bppRgb. For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not.

Exemples

L’exemple de code suivant est conçu pour une utilisation avec Windows Forms et nécessite PaintEventArgs e, qui est un paramètre de la Paint Gestionnaire d’événements.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Le code exécute les actions suivantes :The code performs the following actions:

  • Crée un Bitmap à partir d’un fichier.Creates a Bitmap from a file.

  • Clone une partie de ce Bitmap.Clones a portion of that Bitmap.

  • Dessine la partie clonée à l’écran.Draws the cloned portion to the screen.

private:
   void Clone_Example1( PaintEventArgs^ e )
   {
      // Create a Bitmap object from a file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" );

      // Clone a portion of the Bitmap object.
      Rectangle cloneRect = 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 );
   }
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);
}
Private Sub Clone_Example1(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 Rectangle(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

S’applique à