Bitmap ::Clone(constRect&,PixelFormat) , méthode (gdiplusheaders.h)

Article
03/02/2024

La méthode Bitmap ::Clone crée un objet Bitmap en copiant une partie de cette bitmap.

Syntaxe

Bitmap * Clone(
  const Rect & rect,
  PixelFormat  format
);

Paramètres

rect

Référence à un rectangle qui spécifie la partie de cette bitmap à copier.

format

Entier qui spécifie le format de pixel de la nouvelle bitmap. Le type de données et les constantes PixelFormat qui représentent différents formats de pixels sont définis dans Gdipluspixelformats.h. Pour plus d’informations sur les constantes de format de pixels, consultez Constantes de format de pixel d’image.

Valeur retournée

Type : Bitmap*

Cette méthode retourne un pointeur vers le nouvel objet Bitmap.

Notes

Exemples

L’exemple suivant crée un objet Bitmap à partir d’un fichier image, clone la partie supérieure gauche de l’image, puis dessine l’image cloné.

VOID Example_Clone(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Bitmap object from a JPEG file.
   Bitmap bitmap(L"Climber.jpg");

   // Clone a portion of the bitmap.
   Bitmap* clone = bitmap.Clone(Rect(0, 0, 100, 100), PixelFormatDontCare);

   // Draw the clone.
   graphics.DrawImage(clone, 0, 0);

   delete clone;
}