Bitmap.Clone Bitmap.Clone Bitmap.Clone Bitmap.Clone Method

Definizione

Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.Creates a copy of the section of this Bitmap defined with a specified PixelFormat.

Overload

Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat)

Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat)

Crea una copia della sezione dell'oggetto Bitmap definita dalla struttura Rectangle e con un'enumerazione PixelFormat specificata.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat)

Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

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

Parametri

rect
RectangleF RectangleF RectangleF RectangleF

Definisce la parte dell'oggetto Bitmap da copiare.Defines the portion of this Bitmap to copy.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Specifica l'enumerazione PixelFormat per l'oggetto Bitmap di destinazione.Specifies the PixelFormat enumeration for the destination Bitmap.

Restituisce

Oggetto Bitmap creato con questo metodo.The Bitmap that this method creates.

Eccezioni

rect non è compreso entro i limiti della bitmap di origine.rect is outside of the source bitmap bounds.

L'altezza o la larghezza di rect è uguale a 0.The height or width of rect is 0.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un Bitmap oggetto da un file.Creates a Bitmap from a file.

  • Clona una parte di tale Bitmapoggetto.Clones a portion of that Bitmap.

  • Disegna la parte clonata sullo schermo.Draws the cloned portion to the screen.

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) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat)

Crea una copia della sezione dell'oggetto Bitmap definita dalla struttura Rectangle e con un'enumerazione PixelFormat specificata.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

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

Parametri

rect
Rectangle Rectangle Rectangle Rectangle

Definisce la parte dell'oggetto Bitmap da copiare.Defines the portion of this Bitmap to copy. Le coordinate sono relative a questo oggetto Bitmap.Coordinates are relative to this Bitmap.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Formato pixel per il nuovo oggetto Bitmap.The pixel format for the new Bitmap. Deve specificare un valore che inizia con Format.This must specify a value that begins with Format.

Restituisce

Nuovo oggetto Bitmap creato da questo metodo.The new Bitmap that this method creates.

Eccezioni

rect non è compreso entro i limiti della bitmap di origine.rect is outside of the source bitmap bounds.

L'altezza o la larghezza di rect è uguale a 0.The height or width of rect is 0.

In alternativa-or- Viene specificato un valore PixelFormat il cui nome non inizia con Format.A PixelFormat value is specified whose name does not start with Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un Bitmap oggetto da un file.Creates a Bitmap from a file.

  • Clona una parte di tale Bitmapoggetto.Clones a portion of that Bitmap.

  • Disegna la parte clonata sullo schermo.Draws the cloned portion to the screen.

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

Si applica a