GraphicsPath.GetBounds Méthode

Définition

Retourne un rectangle délimitant ce GraphicsPath.Returns a rectangle that bounds this GraphicsPath.

Surcharges

GetBounds(Matrix)

Retourne un rectangle qui délimite ce GraphicsPath lorsque ce tracé est transformé par le Matrix spécifié.Returns a rectangle that bounds this GraphicsPath when this path is transformed by the specified Matrix.

GetBounds(Matrix, Pen)

Retourne un rectangle délimitant ce GraphicsPath lorsque le tracé en cours est transformé par le Matrix spécifié puis dessiné à l'aide du Pen spécifié.Returns a rectangle that bounds this GraphicsPath when the current path is transformed by the specified Matrix and drawn with the specified Pen.

GetBounds()

Retourne un rectangle délimitant ce GraphicsPath.Returns a rectangle that bounds this GraphicsPath.

GetBounds(Matrix)

Retourne un rectangle qui délimite ce GraphicsPath lorsque ce tracé est transformé par le Matrix spécifié.Returns a rectangle that bounds this GraphicsPath when this path is transformed by the specified Matrix.

public:
 System::Drawing::RectangleF GetBounds(System::Drawing::Drawing2D::Matrix ^ matrix);
public System.Drawing.RectangleF GetBounds (System.Drawing.Drawing2D.Matrix matrix);
member this.GetBounds : System.Drawing.Drawing2D.Matrix -> System.Drawing.RectangleF
Public Function GetBounds (matrix As Matrix) As RectangleF

Paramètres

matrix
Matrix

Matrix qui spécifie une transformation à appliquer à ce tracé avant le calcul du rectangle englobant.The Matrix that specifies a transformation to be applied to this path before the bounding rectangle is calculated. Le tracé n'est pas transformé de manière définitive ; la transformation est utilisée durant le calcul du rectangle englobant uniquement.This path is not permanently transformed; the transformation is used only during the process of calculating the bounding rectangle.

Retours

RectangleF qui représente un rectangle délimitant ce GraphicsPath.A RectangleF that represents a rectangle that bounds this GraphicsPath.

Exemples

Pour obtenir un exemple, consultez GetBounds().For an example, see GetBounds().

Remarques

La taille du rectangle englobant retourné est influencée par le type de la limite de fin, la largeur du stylet et la limite de l’angle du stylet, et produit donc un « ajustement lâche » au tracé délimité.The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. La formule approximative est : le rectangle englobant initial est augmenté de la largeur du stylet, et ce résultat est multiplié par la limite de mitre, plus une marge supplémentaire pour autoriser les extrémités.The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.

GetBounds(Matrix, Pen)

Retourne un rectangle délimitant ce GraphicsPath lorsque le tracé en cours est transformé par le Matrix spécifié puis dessiné à l'aide du Pen spécifié.Returns a rectangle that bounds this GraphicsPath when the current path is transformed by the specified Matrix and drawn with the specified Pen.

public:
 System::Drawing::RectangleF GetBounds(System::Drawing::Drawing2D::Matrix ^ matrix, System::Drawing::Pen ^ pen);
public System.Drawing.RectangleF GetBounds (System.Drawing.Drawing2D.Matrix matrix, System.Drawing.Pen pen);
member this.GetBounds : System.Drawing.Drawing2D.Matrix * System.Drawing.Pen -> System.Drawing.RectangleF
Public Function GetBounds (matrix As Matrix, pen As Pen) As RectangleF

Paramètres

matrix
Matrix

Matrix qui spécifie une transformation à appliquer à ce tracé avant le calcul du rectangle englobant.The Matrix that specifies a transformation to be applied to this path before the bounding rectangle is calculated. Le tracé n'est pas transformé de manière définitive ; la transformation est utilisée durant le calcul du rectangle englobant uniquement.This path is not permanently transformed; the transformation is used only during the process of calculating the bounding rectangle.

pen
Pen

Pen à l'aide duquel dessiner GraphicsPath.The Pen with which to draw the GraphicsPath.

Retours

RectangleF qui représente un rectangle délimitant ce GraphicsPath.A RectangleF that represents a rectangle that bounds this GraphicsPath.

Exemples

Pour obtenir un exemple, consultez GetBounds().For an example, see GetBounds().

Remarques

La taille du rectangle englobant retourné est influencée par le type de la limite de fin, la largeur du stylet et la limite de l’angle du stylet, et produit donc un « ajustement lâche » au tracé délimité.The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. La formule approximative est : le rectangle englobant initial est augmenté de la largeur du stylet, et ce résultat est multiplié par la limite de mitre, plus une marge supplémentaire pour autoriser les extrémités.The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.

GetBounds()

Retourne un rectangle délimitant ce GraphicsPath.Returns a rectangle that bounds this GraphicsPath.

public:
 System::Drawing::RectangleF GetBounds();
public System.Drawing.RectangleF GetBounds ();
member this.GetBounds : unit -> System.Drawing.RectangleF
Public Function GetBounds () As RectangleF

Retours

RectangleF qui représente un rectangle délimitant ce GraphicsPath.A RectangleF that represents a rectangle that bounds this GraphicsPath.

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é graphique.Creates a graphics path.

  • Ajoute une ellipse (cercle) à celle-ci et la dessine à l’écran.Adds an ellipse (circle) to it and draws it to the screen.

  • Récupère le rectangle englobant pour le cercle avec un appel à GetBounds et dessine le rectangle à l’écran.Retrieves the bounding rectangle for the circle with a call to GetBounds and draws the rectangle to the screen.

  • Crée un deuxième tracé graphique.Creates a second graphics path.

  • Ajoute un cercle et élargit le chemin d’accès à une largeur de 10.Adds a circle and widens the path to a width of 10.

  • Dessine le tracé à l’écran.Draws the path to the screen.

  • Récupère le rectangle englobant pour le deuxième cercle.Retrieves the bounding rectangle for the second circle.

  • Dessine le rectangle englobant à l’écran.Draws the bounding rectangle to the screen.

  • Affiche la taille du rectangle dans une boîte de dialogue.Displays the rectangle size in a dialog box.

Notez que le rectangle englobant à droite est plus grand (pour tenir compte de la largeur supplémentaire de la ligne).Notice that the bounding rectangle on the right is larger (to account for the extra width of the line).

public:
   void GetBoundsExample( PaintEventArgs^ e )
   {
      // Create path number 1 and a Pen for drawing.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      Pen^ pathPen = gcnew Pen( Color::Black,1.0f );

      // Add an Ellipse to the path and Draw it (circle in start
      // position).
      myPath->AddEllipse( 20, 20, 100, 100 );
      e->Graphics->DrawPath( pathPen, myPath );

      // Get the path bounds for Path number 1 and draw them.
      RectangleF boundRect = myPath->GetBounds();
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), boundRect.X, boundRect.Y, boundRect.Height, boundRect.Width );

      // Create a second graphics path and a wider Pen.
      GraphicsPath^ myPath2 = gcnew GraphicsPath;
      Pen^ pathPen2 = gcnew Pen( Color::Black,10.0f );

      // Create a new ellipse with a width of 10.
      myPath2->AddEllipse( 150, 20, 100, 100 );
      myPath2->Widen( pathPen2 );
      e->Graphics->FillPath( Brushes::Black, myPath2 );

      // Get the second path bounds.
      RectangleF boundRect2 = myPath2->GetBounds();

      // Draw the bounding rectangle.
      e->Graphics->DrawRectangle( gcnew Pen( Color::Red,1.0f ), boundRect2.X, boundRect2.Y, boundRect2.Height, boundRect2.Width );

      // Display the rectangle size.
      MessageBox::Show( boundRect2.ToString() );
   }
public void GetBoundsExample(PaintEventArgs e)
{
             
    // Create path number 1 and a Pen for drawing.
    GraphicsPath myPath = new GraphicsPath();
    Pen pathPen = new Pen(Color.Black, 1);
             
    // Add an Ellipse to the path and Draw it (circle in start
             
    // position).
    myPath.AddEllipse(20, 20, 100, 100);
    e.Graphics.DrawPath(pathPen, myPath);
             
    // Get the path bounds for Path number 1 and draw them.
    RectangleF boundRect = myPath.GetBounds();
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1),
        boundRect.X,
        boundRect.Y,
        boundRect.Height,
        boundRect.Width);
             
    // Create a second graphics path and a wider Pen.
    GraphicsPath myPath2 = new GraphicsPath();
    Pen pathPen2 = new Pen(Color.Black, 10);
             
    // Create a new ellipse with a width of 10.
    myPath2.AddEllipse(150, 20, 100, 100);
    myPath2.Widen(pathPen2);
    e.Graphics.FillPath(Brushes.Black, myPath2);
             
    // Get the second path bounds.
    RectangleF boundRect2 = myPath2.GetBounds();
             
    // Draw the bounding rectangle.
    e.Graphics.DrawRectangle(new Pen(Color.Red, 1),
        boundRect2.X,
        boundRect2.Y,
        boundRect2.Height,
        boundRect2.Width);
             
    // Display the rectangle size.
    MessageBox.Show(boundRect2.ToString());
}
Public Sub GetBoundsExample(ByVal e As PaintEventArgs)

    ' Create path number 1 and a Pen for drawing.
    Dim myPath As New GraphicsPath
    Dim pathPen As New Pen(Color.Black, 1)

    ' Add an Ellipse to the path and Draw it (circle in start

    ' position).
    myPath.AddEllipse(20, 20, 100, 100)
    e.Graphics.DrawPath(pathPen, myPath)

    ' Get the path bounds for Path number 1 and draw them.
    Dim boundRect As RectangleF = myPath.GetBounds()
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), boundRect.X, _
    boundRect.Y, boundRect.Height, boundRect.Width)

    ' Create a second graphics path and a wider Pen.
    Dim myPath2 As New GraphicsPath
    Dim pathPen2 As New Pen(Color.Black, 10)

    ' Create a new ellipse with a width of 10.
    myPath2.AddEllipse(150, 20, 100, 100)
    myPath2.Widen(pathPen2)
    e.Graphics.FillPath(Brushes.Black, myPath2)

    ' Get the second path bounds.
    Dim boundRect2 As RectangleF = myPath2.GetBounds()

    ' Show the bounds in a message box.
    e.Graphics.DrawString("Rectangle2 Bounds: " + _
    boundRect2.ToString(), New Font("Arial", 8), Brushes.Black, _
    20, 150)

    ' Draw the bounding rectangle.
    e.Graphics.DrawRectangle(New Pen(Color.Red, 1), boundRect2.X, _
    boundRect2.Y, boundRect2.Height, boundRect2.Width)
End Sub

Remarques

La taille du rectangle englobant retourné est influencée par le type de la limite de fin, la largeur du stylet et la limite de l’angle du stylet, et produit donc un « ajustement lâche » au tracé délimité.The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. La formule approximative est : le rectangle englobant initial est augmenté de la largeur du stylet, et ce résultat est multiplié par la limite de mitre, plus une marge supplémentaire pour autoriser les extrémités.The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.

S’applique à