Метод Bitmap::Clone(constRect&,PixelFormat) (gdiplusheaders.h)

Статья
02/26/2024

Метод Bitmap::Clone создает новый объект Bitmap путем копирования части этого растрового изображения.

Синтаксис

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

Параметры

rect

Ссылка на прямоугольник, указывающий часть этого растрового изображения для копирования.

format

Целое число, указывающее формат пикселей нового растрового изображения. Тип данных PixelFormat и константы, представляющие различные форматы пикселей, определяются в Gdipluspixelformats.h. Дополнительные сведения о константах формата пикселей см. в разделе Константы формата пикселей изображений.

Возвращаемое значение

Тип: растровое изображение*

Этот метод возвращает указатель на новый объект Bitmap.

Remarks

Примеры

В следующем примере создается объект Bitmap из файла изображения, клонируется верхняя левая часть изображения, а затем выполняется рисование клонированного изображения.

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