Bitmap.Clone 메서드

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

System.Drawing.Common v8.0.0

지정된 Bitmap과 함께 정의된 해당 PixelFormat 섹션의 복사본을 만듭니다.

오버로드

Clone(RectangleF, PixelFormat)	지정된 Bitmap 열거형과 함께 정의된 해당 PixelFormat 섹션의 복사본을 만듭니다.
Clone(Rectangle, PixelFormat)	지정된 Bitmap 열거형과 함께 Rectangle 구조체에서 정의된 해당 PixelFormat 개체의 섹션 복사본을 만듭니다.

Clone(RectangleF, PixelFormat)

Source:

Bitmap.cs

지정된 Bitmap 열거형과 함께 정의된 해당 PixelFormat 섹션의 복사본을 만듭니다.

public:
 System::Drawing::Bitmap ^ Clone(System::Drawing::RectangleF rect, System::Drawing::Imaging::PixelFormat format);

public System.Drawing.Bitmap Clone (System.Drawing.RectangleF rect, System.Drawing.Imaging.PixelFormat format);

override this.Clone : System.Drawing.RectangleF * System.Drawing.Imaging.PixelFormat -> System.Drawing.Bitmap

Public Function Clone (rect As RectangleF, format As PixelFormat) As Bitmap

매개 변수

rect

RectangleF

해당 Bitmap의 복사할 부분을 정의합니다.

format

PixelFormat

대상 PixelFormat의 Bitmap 열거형을 지정합니다.

반환

Bitmap

이 메서드가 만드는 Bitmap입니다.

예외

OutOfMemoryException

rect가 소스 비트맵의 범위를 벗어난 경우

ArgumentException

rect의 높이나 너비가 0인 경우

예제

다음 코드 예제는 Windows Forms 사용하도록 설계되었으며 이벤트 처리기의 Paint 매개 변수인 가 필요합니다.PaintEventArgse 코드는 다음 작업을 수행합니다.

• Bitmap 파일에서 을 만듭니다.

• 해당 의 일부를 복제합니다 Bitmap.

• 복제된 부분을 화면에 그립니다.

private:
   void Clone_Example2( PaintEventArgs^ e )
   {
      // Create a Bitmap object from a file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" );

      // Clone a portion of the Bitmap object.
      RectangleF cloneRect = RectangleF(0,0,100,100);
      System::Drawing::Imaging::PixelFormat format = myBitmap->PixelFormat;
      Bitmap^ cloneBitmap = myBitmap->Clone( cloneRect, format );

      // Draw the cloned portion of the Bitmap object.
      e->Graphics->DrawImage( cloneBitmap, 0, 0 );
   }

private void Clone_Example2(PaintEventArgs e)
{

    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");

    // Clone a portion of the Bitmap object.
    RectangleF cloneRect = new RectangleF(0, 0, 100, 100);
    System.Drawing.Imaging.PixelFormat format =
        myBitmap.PixelFormat;
    Bitmap cloneBitmap = myBitmap.Clone(cloneRect, format);

    // Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0);
}

Private Sub Clone_Example2(ByVal e As PaintEventArgs)

    ' Create a Bitmap object from a file.
    Dim myBitmap As New Bitmap("Grapes.jpg")

    ' Clone a portion of the Bitmap object.
    Dim cloneRect As New RectangleF(0, 0, 100, 100)
    Dim format As PixelFormat = myBitmap.PixelFormat
    Dim cloneBitmap As Bitmap = myBitmap.Clone(cloneRect, format)

    ' Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0)
End Sub

Clone(Rectangle, PixelFormat)

Source:

Bitmap.cs

지정된 Bitmap 열거형과 함께 Rectangle 구조체에서 정의된 해당 PixelFormat 개체의 섹션 복사본을 만듭니다.

public:
 System::Drawing::Bitmap ^ Clone(System::Drawing::Rectangle rect, System::Drawing::Imaging::PixelFormat format);

public System.Drawing.Bitmap Clone (System.Drawing.Rectangle rect, System.Drawing.Imaging.PixelFormat format);

override this.Clone : System.Drawing.Rectangle * System.Drawing.Imaging.PixelFormat -> System.Drawing.Bitmap

Public Function Clone (rect As Rectangle, format As PixelFormat) As Bitmap

매개 변수

rect

Rectangle

해당 Bitmap의 복사할 부분을 정의합니다. 좌표는 해당 Bitmap에 상대적입니다.

format

PixelFormat

새 Bitmap의 픽셀 형식입니다. 로 시작하는 Format값을 지정해야 합니다.

반환

Bitmap

이 메서드가 만드는 새 Bitmap를 반환합니다.

예외

OutOfMemoryException

rect가 소스 비트맵의 범위를 벗어난 경우

ArgumentException

rect의 높이나 너비가 0인 경우

또는

이름이 서식으로 시작하지 않는 경우, PixelFormat 값이 지정됩니다. 예를 들어, Gdi를 지정하면 ArgumentException이 초래되나, Format48bppRgb는 초래되지 않습니다.

예제

다음 코드 예제는 Windows Forms 사용하도록 설계되었으며 이벤트 처리기의 Paint 매개 변수인 가 필요합니다.PaintEventArgse 코드는 다음 작업을 수행합니다.

• Bitmap 파일에서 을 만듭니다.

• 해당 의 일부를 복제합니다 Bitmap.

• 복제된 부분을 화면에 그립니다.

private:
   void Clone_Example1( PaintEventArgs^ e )
   {
      // Create a Bitmap object from a file.
      Bitmap^ myBitmap = gcnew Bitmap( "Grapes.jpg" );

      // Clone a portion of the Bitmap object.
      Rectangle cloneRect = Rectangle(0,0,100,100);
      System::Drawing::Imaging::PixelFormat format = myBitmap->PixelFormat;
      Bitmap^ cloneBitmap = myBitmap->Clone( cloneRect, format );

      // Draw the cloned portion of the Bitmap object.
      e->Graphics->DrawImage( cloneBitmap, 0, 0 );
   }

private void Clone_Example1(PaintEventArgs e)
{

    // Create a Bitmap object from a file.
    Bitmap myBitmap = new Bitmap("Grapes.jpg");

    // Clone a portion of the Bitmap object.
    Rectangle cloneRect = new Rectangle(0, 0, 100, 100);
    System.Drawing.Imaging.PixelFormat format =
        myBitmap.PixelFormat;
    Bitmap cloneBitmap = myBitmap.Clone(cloneRect, format);

    // Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0);
}

Private Sub Clone_Example1(ByVal e As PaintEventArgs)

    ' Create a Bitmap object from a file.
    Dim myBitmap As New Bitmap("Grapes.jpg")

    ' Clone a portion of the Bitmap object.
    Dim cloneRect As New Rectangle(0, 0, 100, 100)
    Dim format As PixelFormat = myBitmap.PixelFormat
    Dim cloneBitmap As Bitmap = myBitmap.Clone(cloneRect, format)

    ' Draw the cloned portion of the Bitmap object.
    e.Graphics.DrawImage(cloneBitmap, 0, 0)
End Sub