Méthode Region::GetBounds(Rect*,constGraphics*) (gdiplusheaders.h)

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

Syntaxe

Status GetBounds(
  Rect           *rect,
  const Graphics *g
);

Paramètres

rect

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

g

Pointeur vers un objet Graphics qui contient les transformations de monde et de page nécessaires 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 .

Notes

Les transformations de monde et de page actuelles de l’objet graphique sont utilisées pour calculer la région et le rectangle à mesure 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_GetBoundsRect(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));
    Rect 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);
}

Spécifications

Voir aussi

Région

Graphicspath

Rect

État