Condividi tramite

Percorsi di oggetti Graphics in GDI+

  • Articolo

I percorsi sono formati combinando linee, rettangoli e curve semplici. Si ricordi dalla panoramica della grafica vettoriale che i blocchi predefiniti seguenti hanno dimostrato di essere i più utili per disegnare immagini:

  • Righe

  • Rettangoli

  • Ellissi

  • Archi

  • Poligoni

  • Spline cardinali

  • Spline di Bézier

In GDI+, l'oggetto GraphicsPath consente di raccogliere una sequenza di questi blocchi predefiniti in una singola unità. L'intera sequenza di linee, rettangoli, poligoni e curve può quindi essere disegnata con una chiamata al DrawPath metodo della Graphics classe . La figura seguente mostra un percorso creato combinando una linea, un arco, una spline di Bézier e una spline cardinale.

Image of a single-line path, starting from a straight line and continuing into different shapes.

Uso di un percorso

La GraphicsPath classe fornisce i metodi seguenti per creare una sequenza di elementi da disegnare: AddLine, AddRectangle, AddArcAddEllipse, AddPolygonAddCurve (per le spline cardinali) e AddBezier. Ognuno di questi metodi è sottoposto a overload; ovvero, ogni metodo supporta diversi elenchi di parametri. Ad esempio, una variante del AddLine metodo riceve quattro interi e un'altra variante del AddLine metodo riceve due Point oggetti.

I metodi per l'aggiunta di linee, rettangoli e spline bézier a un percorso includono metodi complementari plurali che aggiungono diversi elementi al percorso in una singola chiamata: AddLines, AddRectanglese AddBeziers. Inoltre, i AddCurve metodi e AddArc includono metodi AddClosedCurve complementari e AddPie, che aggiungono una curva chiusa o una torta al percorso.

Per disegnare un percorso, è necessario un Graphics oggetto, un Pen oggetto e un GraphicsPath oggetto . L'oggetto Graphics fornisce il DrawPath metodo e l'oggetto Pen archivia attributi, ad esempio larghezza e colore, della linea utilizzata per eseguire il rendering del percorso. L'oggetto GraphicsPath archivia la sequenza di linee e curve che costituiscono il percorso. L'oggetto Pen e l'oggetto GraphicsPath vengono passati come argomenti al DrawPath metodo . Nell'esempio seguente viene disegnato un percorso costituito da una linea, da un'ellisse e da una spline di Bézier:

myGraphicsPath.AddLine(0, 0, 30, 20);
myGraphicsPath.AddEllipse(20, 20, 20, 40);
myGraphicsPath.AddBezier(30, 60, 70, 60, 50, 30, 100, 10);
myGraphics.DrawPath(myPen, myGraphicsPath);

myGraphicsPath.AddLine(0, 0, 30, 20)
myGraphicsPath.AddEllipse(20, 20, 20, 40)
myGraphicsPath.AddBezier(30, 60, 70, 60, 50, 30, 100, 10)
myGraphics.DrawPath(myPen, myGraphicsPath)

La figura seguente mostra il percorso.

Image of a path displayed within a graph.

Oltre ad aggiungere linee, rettangoli e curve a un percorso, è possibile aggiungere percorsi a un percorso. In questo modo è possibile combinare percorsi esistenti per formare percorsi complessi e di grandi dimensioni.

myGraphicsPath.AddPath(graphicsPath1, false);
myGraphicsPath.AddPath(graphicsPath2, false);

myGraphicsPath.AddPath(graphicsPath1, False)
myGraphicsPath.AddPath(graphicsPath2, False)

Sono disponibili altri due elementi che è possibile aggiungere a un percorso: stringhe e pie. Una torta è una parte dell'interno di un'ellisse. L'esempio seguente crea un percorso da un arco, una spline cardinale, una stringa e una torta:

GraphicsPath myGraphicsPath = new GraphicsPath();

Point[] myPointArray =
{
    new Point(5, 30),
    new Point(20, 40),
    new Point(50, 30)
};

FontFamily myFontFamily = new FontFamily("Times New Roman");
PointF myPointF = new PointF(50, 20);
StringFormat myStringFormat = new StringFormat();

myGraphicsPath.AddArc(0, 0, 30, 20, -90, 180);
myGraphicsPath.StartFigure();
myGraphicsPath.AddCurve(myPointArray);
myGraphicsPath.AddString("a string in a path", myFontFamily,
   0, 24, myPointF, myStringFormat);
myGraphicsPath.AddPie(230, 10, 40, 40, 40, 110);
myGraphics.DrawPath(myPen, myGraphicsPath);

Dim myGraphicsPath As New GraphicsPath()

Dim myPointArray As Point() = { _
   New Point(5, 30), _
   New Point(20, 40), _
   New Point(50, 30)}

Dim myFontFamily As New FontFamily("Times New Roman")
Dim myPointF As New PointF(50, 20)
Dim myStringFormat As New StringFormat()

myGraphicsPath.AddArc(0, 0, 30, 20, -90, 180)
myGraphicsPath.StartFigure()
myGraphicsPath.AddCurve(myPointArray)
myGraphicsPath.AddString("a string in a path", myFontFamily, _
   0, 24, myPointF, myStringFormat)
myGraphicsPath.AddPie(230, 10, 40, 40, 40, 110)
myGraphics.DrawPath(myPen, myGraphicsPath)

La figura seguente mostra il percorso. Si noti che non è necessario connettere un percorso; l'arco, la spline cardinala, la stringa e la torta sono separate.

Paths

Vedi anche