Bitmap::Clone(constRect&,PixelFormat) メソッド (gdiplusheaders.h)

[アーティクル]
02/26/2024

Bitmap::Clone メソッドは、このビットマップの一部をコピーして、新しい Bitmap オブジェクトを作成します。

構文

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

パラメーター

rect

コピーするビットマップの部分を指定する四角形への参照。

format

新しいビットマップのピクセル形式を指定する整数。さまざまなピクセル形式を表す PixelFormat データ型と定数は、Gdipluspixelformats.h で定義されています。ピクセル形式定数の詳細については、「 Image Pixel Format Constants」を参照してください。

戻り値

種類: Bitmap*

このメソッドは、新しい 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;
}