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

为目标 Bitmap 指定 PixelFormat 枚举。

返回

Bitmap

此方法创建的 Bitmap。

例外

OutOfMemoryException

rect 位于源位图边界之外。

ArgumentException

rect 的高度或宽度为 0。

示例

下面的代码示例旨在与 Windows 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 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 窗体 一起使用，它需要 PaintEventArgse，它是 事件处理程序的Paint一个参数。 此代码执行以下操作：

• 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