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

 

Draws a GraphicsPath.

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

public:
void DrawPath(
	Pen^ pen,
	GraphicsPath^ path
)

Parameters

pen
Type: System.Drawing::Pen^

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

path
Type: System.Drawing.Drawing2D::GraphicsPath^

GraphicsPath to draw.

Exception Condition
ArgumentNullException

pen is null.

-or-

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.

public:
   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
Show: