PathGradientBrush ::SetCenterColor, méthode (gdipluspath.h)

Article
02/27/2024

La méthode PathGradientBrush ::SetCenterColor définit la couleur centrale de ce pinceau de dégradé de chemin. La couleur du centre est la couleur qui apparaît au point central du pinceau.

Syntaxe

Status SetCenterColor(
  [in, ref] const Color & color
);

Paramètres

[in, ref] color

Type : const Color

Référence à un objet Color qui spécifie la couleur centrale.

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

Par défaut, le point central est le centroïde du chemin de limite du pinceau, mais vous pouvez définir le point central à n’importe quel emplacement à l’intérieur ou à l’extérieur du chemin.

Exemples

L’exemple suivant crée un objet PathGradientBrush basé sur une ellipse. Le code appelle la méthode PathGradientBrush ::SetCenterColor de l’objet PathGradientBrush pour définir la couleur centrale sur bleu. La méthode PathGradientBrush ::SetSurroundColors définit la couleur le long de la limite entière sur aqua. La méthode FillRectangle Methods utilise le pinceau dégradé de chemin pour peindre un rectangle qui contient l’ellipse.

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 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); 
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	gdipluspath.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll