Procedura: creare oggetti Graphics per disegnare

  • Articolo

Prima di poter disegnare linee e forme, eseguire il rendering di testo o visualizzare e modificare le immagini con GDI+, è necessario creare un Graphics oggetto . L'oggetto Graphics rappresenta una superficie di disegno GDI+ ed è l'oggetto utilizzato per creare immagini grafiche.

Esistono due passaggi per lavorare con la grafica:

  1. Creazione di un Graphics oggetto .

  2. Utilizzo dell'oggetto per disegnare linee e forme, eseguire il Graphics rendering di testo o visualizzare e modificare le immagini.

Creazione di un oggetto grafico

Un oggetto grafico può essere creato in diversi modi.

Per creare un oggetto grafico

  • Ricevere un riferimento a un oggetto grafico come parte di nell'evento PaintEventArgsPaint di una maschera o di un controllo. Questo è in genere il modo in cui si ottiene un riferimento a un oggetto grafico durante la creazione di codice di disegno per un controllo. Analogamente, è anche possibile ottenere un oggetto grafico come proprietà di PrintPageEventArgs quando si gestisce l'evento PrintPage per un oggetto PrintDocument.

    -oppure-

  • Chiamare il CreateGraphics metodo di un controllo o di una maschera per ottenere un riferimento a un Graphics oggetto che rappresenta la superficie di disegno di tale controllo o maschera. Utilizzare questo metodo se si desidera disegnare su una maschera o un controllo già esistente.

    -oppure-

  • Creare un Graphics oggetto da qualsiasi oggetto che eredita da Image. Questo approccio è utile quando si vuole modificare un'immagine già esistente.

    Nelle sezioni seguenti vengono fornite informazioni dettagliate su ognuno di questi processi.

PaintEventArgs nel gestore eventi Paint

Quando si programma PaintEventHandler per i controlli o PrintPage per un PrintDocumentoggetto , un oggetto grafico viene fornito come una delle proprietà di PaintEventArgs o PrintPageEventArgs.

Per ottenere un riferimento a un oggetto Graphics da PaintEventArgs nell'evento Paint

  1. Dichiarare l'oggetto Graphics .

  2. Assegnare la variabile per fare riferimento all'oggetto Graphics passato come parte di PaintEventArgs.

  3. Inserire il codice per disegnare la maschera o il controllo.

    Nell'esempio seguente viene illustrato come fare riferimento a un Graphics oggetto da PaintEventArgs nell'evento Paint :

    Private Sub Form1_Paint(sender As Object, pe As PaintEventArgs) Handles _  
   MyBase.Paint  
   ' Declares the Graphics object and sets it to the Graphics object  
   ' supplied in the PaintEventArgs.  
   Dim g As Graphics = pe.Graphics  
   ' Insert code to paint the form here.  
End Sub  

    private void Form1_Paint(object sender,
   System.Windows.Forms.PaintEventArgs pe)
{  
   // Declares the Graphics object and sets it to the Graphics object  
   // supplied in the PaintEventArgs.  
   Graphics g = pe.Graphics;  
   // Insert code to paint the form here.  
}  

    private:  
   void Form1_Paint(System::Object ^ sender,  
      System::Windows::Forms::PaintEventArgs ^ pe)  
   {  
      // Declares the Graphics object and sets it to the Graphics object  
      // supplied in the PaintEventArgs.  
      Graphics ^ g = pe->Graphics;  
      // Insert code to paint the form here.  
   }

CreateGraphics, metodo

È inoltre possibile utilizzare il CreateGraphics metodo di un controllo o di una maschera per ottenere un riferimento a un Graphics oggetto che rappresenta la superficie di disegno di tale controllo o maschera.

Per creare un oggetto Graphics con il metodo CreateGraphics

  • Chiamare il CreateGraphics metodo della maschera o del controllo su cui si desidera eseguire il rendering della grafica.

    Dim g as Graphics  
' Sets g to a Graphics object representing the drawing surface of the  
' control or form g is a member of.  
g = Me.CreateGraphics  

    Graphics g;  
// Sets g to a graphics object representing the drawing surface of the  
// control or form g is a member of.  
g = this.CreateGraphics();  

    Graphics ^ g;  
// Sets g to a graphics object representing the drawing surface of the  
// control or form g is a member of.  
g = this->CreateGraphics();

Crea da un oggetto Image

Inoltre, è possibile creare un oggetto grafico da qualsiasi oggetto che deriva dalla Image classe .

Per creare un oggetto Graphics da un'immagine

  • Chiamare il Graphics.FromImage metodo specificando il nome della variabile Image da cui si vuole creare un Graphics oggetto.

    Nell'esempio seguente viene illustrato come usare un Bitmap oggetto :

    Dim myBitmap as New Bitmap("C:\Documents and Settings\Joe\Pics\myPic.bmp")  
Dim g as Graphics = Graphics.FromImage(myBitmap)  

    Bitmap myBitmap = new Bitmap(@"C:\Documents and
   Settings\Joe\Pics\myPic.bmp");  
Graphics g = Graphics.FromImage(myBitmap);  

    Bitmap ^ myBitmap = gcnew  
   Bitmap("D:\\Documents and Settings\\Joe\\Pics\\myPic.bmp");  
Graphics ^ g = Graphics::FromImage(myBitmap);

Nota

È possibile creare Graphics oggetti solo da file con estensione bmp non indicizzati, ad esempio file con estensione bmp a 16 bit, a 24 bit e a 32 bit. Ogni pixel di file con estensione bmp non indicizzata contiene un colore, a differenza dei pixel dei file con estensione bmp indicizzati, che contengono un indice in una tabella colori.

Disegno e modifica di forme e immagini

Dopo la creazione, è possibile utilizzare un Graphics oggetto per disegnare linee e forme, eseguire il rendering di testo o visualizzare e modificare le immagini. Gli oggetti principale utilizzati con l'oggetto Graphics sono:

  • Classe Pen utilizzata per disegnare linee, strutturare forme o eseguire il rendering di altre rappresentazioni geometriche.

  • Classe Brush : utilizzata per riempire aree di grafica, ad esempio forme riempite, immagini o testo.

  • Classe Font : fornisce una descrizione delle forme da utilizzare per il rendering del testo.

  • Struttura Color : rappresenta i diversi colori da visualizzare.

Per utilizzare l'oggetto Graphics creato

Vedi anche