Bitmap.Clone Metodo

Definizione

Spazio dei nomi:: System.Drawing

Assembly:: System.Drawing.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea una copia della sezione di definita Bitmap con un oggetto specificato PixelFormat.

Overload

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

Clone(RectangleF, PixelFormat)

Crea una copia della sezione di definita Bitmap con un'enumerazione specificata 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

Parametri

rect: RectangleF

Definisce la parte di questa Bitmap da copiare.

format: PixelFormat

Specifica l'enumerazione PixelFormat per la destinazione Bitmap.

Valori restituiti

Bitmap

Oggetto Bitmap creato da questo metodo.

Eccezioni

OutOfMemoryException

rect non rientra nei limiti bitmap di origine.

ArgumentException

L'altezza o la larghezza di rect è 0.

Esempio

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

Crea un oggetto Bitmap 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

Si applica a

Clone(Rectangle, PixelFormat)

Crea una copia della sezione di definita Bitmap dalla Rectangle struttura e con un'enumerazione specificata 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

Parametri

rect: Rectangle

Definisce la parte di questa Bitmap da copiare. Le coordinate sono relative all'oggetto Bitmap.

format: PixelFormat

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

Valori restituiti

Bitmap

Nuovo creato Bitmap da questo metodo.

Eccezioni

OutOfMemoryException

rect non rientra nei limiti bitmap di origine.

ArgumentException

L'altezza o la larghezza di rect è 0.

oppure

Viene specificato un PixelFormat valore il cui nome non inizia con Format. Ad esempio, la specifica Gdi di causerà un oggetto ArgumentException, ma Format48bppRgb non lo sarà.

Esempio

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

Crea un oggetto Bitmap 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

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?