GraphicsPath.Widen Méthode

Définition

Remplace ce tracé par des courbes englobant la zone remplie lorsque ce tracé est dessiné à l'aide du stylet spécifié.Replaces this path with curves that enclose the area that is filled when this path is drawn by the specified pen.

Surcharges

Widen(Pen)

Ajoute un contour supplémentaire au tracé.Adds an additional outline to the path.

Widen(Pen, Matrix)

Ajoute un contour supplémentaire au GraphicsPath.Adds an additional outline to the GraphicsPath.

Widen(Pen, Matrix, Single)

Remplace ce GraphicsPath par des courbes englobant la zone remplie lorsque ce tracé est dessiné à l'aide du stylet spécifié.Replaces this GraphicsPath with curves that enclose the area that is filled when this path is drawn by the specified pen.

Widen(Pen)

Ajoute un contour supplémentaire au tracé.Adds an additional outline to the path.

public:
 void Widen(System::Drawing::Pen ^ pen);
public void Widen (System.Drawing.Pen pen);
member this.Widen : System.Drawing.Pen -> unit
Public Sub Widen (pen As Pen)

Paramètres

pen
Pen

Pen qui spécifie la largeur entre le contour d'origine du tracé et le nouveau contour créé par cette méthode.A Pen that specifies the width between the original outline of the path and the new outline this method creates.

Exemples

Pour obtenir un exemple, consultez Widen(Pen, Matrix, Single).For an example, see Widen(Pen, Matrix, Single).

Remarques

Cette méthode crée un contour autour des lignes d’origine de cette GraphicsPath, avec une distance entre les lignes existantes et le nouveau contour égale à celle de la largeur du Pen utilisé dans l’appel à Widen.This method creates an outline around the original lines in this GraphicsPath, with a distance between the existing lines and the new outline equal to that of the width of the Pen used in the call to Widen. Si vous souhaitez remplir l’espace entre les lignes, vous devez utiliser le FillPath plutôt que le DrawPath.If you want to fill the space between the lines you must use the FillPath rather then the DrawPath.

Widen(Pen, Matrix)

Ajoute un contour supplémentaire au GraphicsPath.Adds an additional outline to the GraphicsPath.

public:
 void Widen(System::Drawing::Pen ^ pen, System::Drawing::Drawing2D::Matrix ^ matrix);
public void Widen (System.Drawing.Pen pen, System.Drawing.Drawing2D.Matrix matrix);
member this.Widen : System.Drawing.Pen * System.Drawing.Drawing2D.Matrix -> unit
Public Sub Widen (pen As Pen, matrix As Matrix)

Paramètres

pen
Pen

Pen qui spécifie la largeur entre le contour d'origine du tracé et le nouveau contour créé par cette méthode.A Pen that specifies the width between the original outline of the path and the new outline this method creates.

matrix
Matrix

Matrix spécifiant la transformation à appliquer au tracé avant de l'élargir.A Matrix that specifies a transform to apply to the path before widening.

Exemples

Pour obtenir un exemple, consultez Widen(Pen, Matrix, Single).For an example, see Widen(Pen, Matrix, Single).

Remarques

Cette méthode crée un contour autour des lignes d’origine de cette GraphicsPath, avec une distance entre les lignes existantes et le nouveau contour égale à celle de la largeur du Pen utilisé dans l’appel à Widen.This method creates an outline around the original lines in this GraphicsPath, with a distance between the existing lines and the new outline equal to that of the width of the Pen used in the call to Widen. Si vous souhaitez remplir l’espace entre les lignes, vous devez utiliser le FillPath plutôt que le DrawPath.If you want to fill the space between the lines you must use the FillPath rather then the DrawPath.

Widen(Pen, Matrix, Single)

Remplace ce GraphicsPath par des courbes englobant la zone remplie lorsque ce tracé est dessiné à l'aide du stylet spécifié.Replaces this GraphicsPath with curves that enclose the area that is filled when this path is drawn by the specified pen.

public:
 void Widen(System::Drawing::Pen ^ pen, System::Drawing::Drawing2D::Matrix ^ matrix, float flatness);
public void Widen (System.Drawing.Pen pen, System.Drawing.Drawing2D.Matrix matrix, float flatness);
member this.Widen : System.Drawing.Pen * System.Drawing.Drawing2D.Matrix * single -> unit
Public Sub Widen (pen As Pen, matrix As Matrix, flatness As Single)

Paramètres

pen
Pen

Pen qui spécifie la largeur entre le contour d'origine du tracé et le nouveau contour créé par cette méthode.A Pen that specifies the width between the original outline of the path and the new outline this method creates.

matrix
Matrix

Matrix spécifiant la transformation à appliquer au tracé avant de l'élargir.A Matrix that specifies a transform to apply to the path before widening.

flatness
Single

Valeur qui spécifie l'apparence à deux dimensions des courbes.A value that specifies the flatness for curves.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms, et il requiert PaintEventArgse, un objet d’événement OnPaint.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. Le code effectue les actions suivantes :The code performs the following actions:

  • Crée un tracé et ajoute deux ellipses au tracé.Creates a path and adds two ellipses to the path.

  • Dessine le tracé en noir.Draws the path in black.

  • Élargit le chemin d’accès.Widens the path.

  • Dessine le tracé en rouge.Draws the path in red.

Notez que le deuxième rendu utilise FillPath au lieu de DrawPath, et par conséquent, le contour est rempli pour la figure rendue.Notice that the second rendering uses FillPath instead of DrawPath, and hence the rendered figure has the outline filled.

private:
   void WidenExample( PaintEventArgs^ e )
   {
      // Create a path and add two ellipses.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddEllipse( 0, 0, 100, 100 );
      myPath->AddEllipse( 100, 0, 100, 100 );

      // Draw the original ellipses to the screen in black.
      e->Graphics->DrawPath( Pens::Black, myPath );

      // Widen the path.
      Pen^ widenPen = gcnew Pen( Color::Black,10.0f );
      Matrix^ widenMatrix = gcnew Matrix;
      widenMatrix->Translate( 50, 50 );
      myPath->Widen( widenPen, widenMatrix, 1.0f );

      // Draw the widened path to the screen in red.
      e->Graphics->FillPath( gcnew SolidBrush( Color::Red ), myPath );
   }
private void WidenExample(PaintEventArgs e)
{
             
    // Create a path and add two ellipses.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddEllipse(0, 0, 100, 100);
    myPath.AddEllipse(100, 0, 100, 100);
             
    // Draw the original ellipses to the screen in black.
    e.Graphics.DrawPath(Pens.Black, myPath);
             
    // Widen the path.
    Pen widenPen = new Pen(Color.Black, 10);
    Matrix widenMatrix = new Matrix();
    widenMatrix.Translate(50, 50);
    myPath.Widen(widenPen, widenMatrix, 1.0f);
             
    // Draw the widened path to the screen in red.
    e.Graphics.FillPath(new SolidBrush(Color.Red), myPath);
}
Public Sub WidenExample(ByVal e As PaintEventArgs)
    Dim myPath As New GraphicsPath
    myPath.AddEllipse(0, 0, 100, 100)
    myPath.AddEllipse(100, 0, 100, 100)
    e.Graphics.DrawPath(Pens.Black, myPath)
    Dim widenPen As New Pen(Color.Black, 10)
    Dim widenMatrix As New Matrix
    widenMatrix.Translate(50, 50)
    myPath.Widen(widenPen, widenMatrix, 1.0F)
    ' Sets tension for curves.
    e.Graphics.FillPath(New SolidBrush(Color.Red), myPath)
End Sub

Remarques

Cette méthode crée un contour autour des lignes d’origine de cette GraphicsPath, avec une distance entre les lignes existantes et le nouveau contour égale à celle de la largeur du Pen utilisé dans l’appel à Widen.This method creates an outline around the original lines in this GraphicsPath, with a distance between the existing lines and the new outline equal to that of the width of the Pen used in the call to Widen. Si vous souhaitez remplir l’espace entre les lignes, vous devez utiliser le FillPath plutôt que le DrawPath.If you want to fill the space between the lines you must use the FillPath rather then the DrawPath.

S’applique à