Bitmap：：Clone (constRect&，PixelFormat) 方法 (gdiplusheaders.h)

發行項
02/29/2024

Bitmap：：Clone 方法會複製此點陣圖的一部分，以建立新的 Bitmap 物件。

語法

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

參數

rect

矩形的參考，指定要複製的這個點陣圖部分。

format

指定新點陣圖圖圖格式的整數。代表各種像素格式的 PixelFormat 資料類型和常數是在 Gdipluspixelformats.h 中定義。如需圖元格式常數的詳細資訊，請參閱影像圖元格式常數。

傳回值

類型：點陣圖*

這個方法會傳回新 Bitmap 物件的指標。

備註

範例

下列範例會從圖像檔建立 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;
}