Bitmap.Clone 메서드

정의

네임스페이스:

System.Drawing

어셈블리:

System.Drawing.Common.dll

패키지:

System.Drawing.Common v9.0.0-preview.5.24306.5

지정된 PixelFormat사용하여 정의된 이 Bitmap 섹션의 복사본을 만듭니다.

오버로드

Clone(RectangleF, PixelFormat)	지정된 PixelFormat 열거형으로 정의된 이 Bitmap 섹션의 복사본을 만듭니다.
Clone(Rectangle, PixelFormat)	Rectangle 구조체 및 지정된 PixelFormat 열거형으로 정의된 이 Bitmap 섹션의 복사본을 만듭니다.

Clone(RectangleF, PixelFormat)

Source:

Bitmap.cs

지정된 PixelFormat 열거형으로 정의된 이 Bitmap 섹션의 복사본을 만듭니다.

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

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

반환

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

Rectangle 구조체 및 지정된 PixelFormat 열거형으로 정의된 이 Bitmap 섹션의 복사본을 만듭니다.

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입니다.

-또는-

이름이 Format시작되지 않는 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