Graphics::DrawPath Method (Pen^, GraphicsPath^)


Draws a GraphicsPath.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

void DrawPath(
	Pen^ pen,
	GraphicsPath^ path


Type: System.Drawing::Pen^

Pen that determines the color, width, and style of the path.

Type: System.Drawing.Drawing2D::GraphicsPath^

GraphicsPath to draw.

Exception Condition

pen is null.


path is null.

The current transformation in the graphic context is applied to the GraphicsPath before it is drawn.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a graphics path object and adds an ellipse to it.

  • Creates a black pen.

  • Draws the graphics path to the screen.

   void DrawPathEllipse( PaintEventArgs^ e )
      // Create graphics path object and add ellipse.
      GraphicsPath^ graphPath = gcnew GraphicsPath;
      graphPath->AddEllipse( 0, 0, 200, 100 );

      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Draw graphics path to screen.
      e->Graphics->DrawPath( blackPen, graphPath );

.NET Framework
Available since 1.1
Return to top