Graphics.FromImage(Image) Graphics.FromImage(Image) Graphics.FromImage(Image) Method

Definizione

Crea un nuovo oggetto Graphics dall'oggetto Image specificato.Creates a new Graphics from the specified Image.

public:
 static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);
public static System.Drawing.Graphics FromImage (System.Drawing.Image image);
static member FromImage : System.Drawing.Image -> System.Drawing.Graphics

Parametri

image
Image Image Image

Image da cui creare il nuovo Graphics.Image from which to create the new Graphics.

Restituisce

Questo metodo restituisce una nuova classe Graphics per la classe Image specificata.This method returns a new Graphics for the specified Image.

Eccezioni

image presenta un formato a pixel indicizzato oppure il formato non è definito.image has an indexed pixel format or its format is undefined.

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. Il codice esegue l'azione seguente:The code performs the following action:

  • Crea un Image oggetto da un file di grafica SampImag. jpg nella cartella di esempio.Creates an Image from a graphics file SampImag.jpg in the example folder.

  • Crea un Graphics oggetto dall' Imageoggetto.Creates a Graphics from the Image.

  • Modifica l'immagine riempiendo un rettangolo al suo interno.Alters the image by filling a rectangle within it.

  • Disegna l' Image oggetto sullo schermo.Draws the Image to the screen.

  • Rilascia l'oggetto Graphicscreato.Releases the created Graphics.

public:
   void FromImageImage( PaintEventArgs^ e )
   {
      // Create image.
      Image^ imageFile = Image::FromFile( "SampImag.jpg" );

      // Create graphics object for alteration.
      Graphics^ newGraphics = Graphics::FromImage( imageFile );

      // Alter image.
      newGraphics->FillRectangle( gcnew SolidBrush( Color::Black ), 100, 50, 100, 100 );

      // Draw image to screen.
      e->Graphics->DrawImage( imageFile, PointF(0.0F,0.0F) );

      // Dispose of graphics object.
      delete newGraphics;
   }
private void FromImageImage(PaintEventArgs e)
{

    // Create image.
    Image imageFile = Image.FromFile("SampImag.jpg");

    // Create graphics object for alteration.
    Graphics newGraphics = Graphics.FromImage(imageFile);

    // Alter image.
    newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100);

    // Draw image to screen.
    e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F));

    // Dispose of graphics object.
    newGraphics.Dispose();
}
Private Sub FromImageImage2(ByVal e As PaintEventArgs)

    ' Create image.
    Dim imageFile As Image = Image.FromFile("SampImag.jpg")

    ' Create graphics object for alteration.
    Dim newGraphics As Graphics = Graphics.FromImage(imageFile)

    ' Alter image.
    newGraphics.FillRectangle(New SolidBrush(Color.Black), _
    100, 50, 100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(imageFile, New PointF(0.0F, 0.0F))

    ' Dispose of graphics object.
    newGraphics.Dispose()
End Sub

Commenti

Se l'immagine ha un formato pixel indicizzato, questo metodo genera un'eccezione con il messaggio "Impossibile creare un oggetto Graphics da un'immagine con formato pixel indicizzato".If the image has an indexed pixel format, this method throws an exception with the message, "A Graphics object cannot be created from an image that has an indexed pixel format." I formati dei pixel indicizzati sono indicati nell'elenco seguente.The indexed pixel formats are shown in the following list.

È possibile salvare l'immagine indicizzata in un altro formato usando il Save(String, ImageFormat) metodo e quindi recuperare un Graphics oggetto per la nuova immagine.You can save the indexed image as another format by using the Save(String, ImageFormat) method and then retrieve a Graphics object for the new image.

Questo metodo genera anche un'eccezione se l'immagine ha uno dei seguenti formati pixel.This method also throws an exception if the image has any of the following pixel formats.

È sempre necessario chiamare il Dispose metodo per rilasciare le Graphics risorse FromImage correlate e create dal metodo.You should always call the Dispose method to release the Graphics and related resources created by the FromImage method.

Si applica a

Vedi anche