Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Bitmap.Clone méthode (Rectangle, PixelFormat)

 

Date de publication : novembre 2016

Crée une copie de la section de ce Bitmap défini par Rectangle structure et avec un PixelFormat (énumération).

Espace de noms:   System.Drawing
Assembly:  System.Drawing (dans System.Drawing.dll)

public Bitmap Clone(
	Rectangle rect,
	PixelFormat format
)

Paramètres

rect
Type: System.Drawing.Rectangle

Définit la partie de ce Bitmap à copier. Coordonnées sont exprimées par rapport à cette Bitmap.

format
Type: System.Drawing.Imaging.PixelFormat

Le format de pixel de la nouvelle Bitmap. Il doit spécifier une valeur qui commence par Format.

Valeur de retour

Type: System.Drawing.Bitmap

Nouveau Bitmap créé par cette méthode.

Exception Condition
OutOfMemoryException

rect est en dehors des limites de la bitmap source.

ArgumentException

La hauteur ou la largeur de rect est 0.

ou

Un PixelFormat valeur n’est spécifiée, dont le nom ne commence pas par Format. Par exemple, la spécification Gdi entraîne une ArgumentException, mais Format48bppRgb ne sera pas.

L'exemple de code suivant est conçu pour une utilisation avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre de la Paint Gestionnaire d'événements. Le code exécute les actions suivantes :

  • Crée un Bitmap à partir d’un fichier.

  • Clone une partie de ce Bitmap.

  • Dessine la partie clonée à l’écran.

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);
}

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: