PathGradientBrush ::SetCenterPoint(constPointF&) méthode (gdipluspath.h)

Article
07/16/2024

La méthode PathGradientBrush ::SetCenterPoint définit le point central de ce pinceau de dégradé de chemin. Par défaut, le point central se trouve au centroïde du chemin de limite du pinceau, mais vous pouvez définir le point central sur n’importe quel emplacement à l’intérieur ou à l’extérieur du chemin.

Syntaxe

Status SetCenterPoint(
  const PointF & point
);

Paramètres

point

Référence à un objet PointF qui spécifie le point central.

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 ellipse. Le code définit la couleur centrale sur bleu et définit la couleur le long de la limite sur aqua. Par défaut, le point central se trouverait au centre de l’ellipse (100, 50), mais l’appel à la méthode PathGradientBrush ::SetCenterPoint définit le point central sur (180.5, 50.0).

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

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the center point.
   pthGrBrush.SetCenterPoint(PointF(180.5f, 50.0f));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300);
}