Region ::GetBounds(RectF*,constGraphics*), méthode (gdiplusheaders.h)

La méthode Region ::GetBounds obtient un rectangle qui entoure cette région.

Syntaxe

Status GetBounds(
  [out] RectF          *rect,
  [in]  const Graphics *g
);

Paramètres

[out] rect

Type : RectF*

Pointeur vers un objet RectF qui reçoit le rectangle englobant.

[in] g

Type : const Graphics*

Pointeur vers un objet Graphics qui contient les transformations de monde et de page requises pour calculer les coordonnées d’appareil de cette région et du rectangle.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Les transformations de monde et de page actuelles de l’objet graphique sont utilisées pour calculer la région et le rectangle tels qu’ils sont dessinés sur l’appareil d’affichage. Le rectangle retourné par Region ::GetBounds n’est pas toujours le plus petit rectangle possible.

Exemples

L’exemple suivant crée une région à partir d’un chemin, obtient le rectangle englobant de la région, puis affiche les deux.

VOID Example_GetBoundsRectF(HDC hdc)
{
   Graphics graphics(hdc);

   Point points[] = {
      Point(110, 20),
      Point(120, 30),
      Point(100, 60),
      Point(120, 70),
      Point(150, 60),
      Point(140, 10)};

   GraphicsPath path;
    SolidBrush solidBrush(Color(255, 255, 0, 0));
    Pen pen(Color(255, 0, 0, 0));
    RectF rect;

   path.AddClosedCurve(points, 6);

    // Create a region from a path.
    Region pathRegion(&path);
    
    // Get the region's enclosing rectangle.
    pathRegion.GetBounds(&rect, &graphics);

    // Show the region and the enclosing rectangle.
    graphics.FillRegion(&solidBrush, &pathRegion);
    graphics.DrawRectangle(&pen, rect);
}

Configuration requise

Voir aussi

Graphicspath

Région