Bitmap.Clone 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

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

创建使用指定 PixelFormat定义的此 Bitmap 节的副本。

重载

Clone(RectangleF, PixelFormat)	创建使用指定 PixelFormat 枚举定义的此 Bitmap 节的副本。
Clone(Rectangle, PixelFormat)	使用指定的 PixelFormat 枚举创建 Rectangle 结构定义的此 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 窗体，它需要 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

使用指定的 PixelFormat 枚举创建 Rectangle 结构定义的此 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。

-或-

指定 PixelFormat 值，其名称不以 Format开头。 例如，指定 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