Bitmap::Clone(constRect&,PixelFormat)-Methode (gdiplusheaders.h)

Artikel
03/01/2024

Die Bitmap::Clone-Methode erstellt ein neues Bitmap-Objekt , indem ein Teil dieser Bitmap kopiert wird.

Syntax

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

Parameter

rect

Verweis auf ein Rechteck, das den teil dieser Bitmap angibt, der kopiert werden soll.

format

Ganze Zahl, die das Pixelformat der neuen Bitmap angibt. Der PixelFormat-Datentyp und die Konstanten, die verschiedene Pixelformate darstellen, sind in Gdipluspixelformats.h definiert. Weitere Informationen zu Pixelformatkonstanten finden Sie unter Bildpixelformatkonstanten.

Rückgabewert

Typ: Bitmap*

Diese Methode gibt einen Zeiger auf das neue Bitmap-Objekt zurück.

Bemerkungen

Beispiele

Im folgenden Beispiel wird ein Bitmap-Objekt aus einer Bilddatei erstellt, der obere linke Teil des Bilds geklont und dann das geklonte Bild zeichnert.

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