PathGradientBrush ::GetRectangle(RectF*) méthode (gdipluspath.h)

Article
07/16/2024

La méthode PathGradientBrush ::GetRectangle obtient le plus petit rectangle qui entoure le chemin de limite de ce pinceau de dégradé de chemin d’accès.

Syntaxe

Status GetRectangle(
  RectF *rect
);

Paramètres

rect

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

Valeur de retour

type : d’é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

Exemples

L’exemple suivant crée un objet PathGradientBrush basé sur un polygone défini par quatre points. Le code appelle la méthode PathGradientBrush ::GetRectangle de l’objet PathGradientBrush pour obtenir le plus petit rectangle qui entoure le chemin de limite du pinceau. Le code appelle la méthode Graphics ::FillRectangle d’un objet Graphics, en passant l’adresse de l’objet PathGradientBrush et une référence au rectangle englobant du pinceau. Cet appel remplit uniquement la partie du rectangle englobant qui se trouve à l’intérieur du chemin de limite du pinceau. Enfin, le code dessine le contour du rectangle englobant.

VOID Example_GetRect(HDC hdc)
{
   Graphics graphics(hdc);
   Pen pen(Color(255, 0, 0, 0));

   // Create a path gradient brush based on an array of points.
   Point points[] = {
      Point(30, 20),
      Point(150, 40),
      Point(100, 100),
      Point(60, 200) };

   PathGradientBrush pthGrBrush(points, 4);

   // Obtain information about the path gradient brush.
   RectF rect;
   pthGrBrush.GetRectangle(&rect);

   graphics.FillRectangle(&pthGrBrush, rect);
   graphics.DrawRectangle(&pen, rect);
}