Bitmap.Clone Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.

Overload

Clone(RectangleF, PixelFormat)	Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.
Clone(Rectangle, PixelFormat)	Crea una copia della sezione dell'oggetto Bitmap definita dalla struttura Rectangle e con un'enumerazione PixelFormat specificata.

Clone(RectangleF, PixelFormat)

Origine:

Bitmap.cs

Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.

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

Definisce la parte dell'oggetto Bitmap da copiare.

format

PixelFormat

Specifica l'enumerazione PixelFormat per l'oggetto Bitmap di destinazione.

Restituisce

Bitmap

Oggetto Bitmap creato con questo metodo.

Eccezioni

OutOfMemoryException

rect non è compreso entro i limiti della bitmap di origine.

ArgumentException

L'altezza o la larghezza di rect è uguale a 0.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea un Bitmap oggetto da un file.

• Clona una parte di tale Bitmapoggetto .

• Disegna la parte clonata sullo schermo.

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)

Origine:

Bitmap.cs

Crea una copia della sezione dell'oggetto Bitmap definita dalla struttura Rectangle e con un'enumerazione PixelFormat specificata.

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

Definisce la parte dell'oggetto Bitmap da copiare. Le coordinate sono relative a questo oggetto Bitmap.

format

PixelFormat

Formato pixel per il nuovo oggetto Bitmap. Deve specificare un valore che inizia con Format.

Restituisce

Bitmap

Nuovo oggetto Bitmap creato da questo metodo.

Eccezioni

OutOfMemoryException

rect non è compreso entro i limiti della bitmap di origine.

ArgumentException

L'altezza o la larghezza di rect è uguale a 0.

-oppure-

Viene specificato un valore PixelFormat il cui nome non inizia con Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del Paint gestore eventi. Il codice esegue le azioni seguenti:

• Crea un Bitmap oggetto da un file.

• Clona una parte di tale Bitmapoggetto .

• Disegna la parte clonata sullo schermo.

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