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

Article
08/24/2023

La méthode PathGradientBrush::SetSurroundColors définit les couleurs d’entourage de ce pinceau dégradé de chemin d’accès. Les couleurs de contour sont des couleurs spécifiées pour les points discrets sur le chemin de limite du pinceau.

Syntaxe

Status SetSurroundColors(
  [in]      const Color *colors,
  [in, out] INT         *count
);

Paramètres

[in] colors

Type : const Color*

Pointeur vers un tableau d’objets Color qui spécifient les couleurs d’entourage.

[in, out] count

Type : INT*

Pointeur vers un entier qui, à l’entrée, spécifie le nombre d’objets Color dans le tableau de couleurs . Si la méthode réussit, ce paramètre, lors de la sortie, reçoit le nombre de couleurs d’entourage définies. Si la méthode échoue, ce paramètre ne reçoit pas de valeur.

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

Un pinceau de dégradé de chemin a un chemin de limite et un point central. Le point central est défini sur une couleur unique, mais vous pouvez spécifier différentes couleurs pour plusieurs points de la limite. Par exemple, supposons que vous spécifiez le rouge pour la couleur centrale, et que vous spécifiez le bleu, le vert et le jaune pour les points distincts sur la limite. Ensuite, à mesure que vous vous déplacez le long de la limite, la couleur passe progressivement du bleu au vert au jaune, puis au bleu. Lorsque vous vous déplacez le long d’une ligne droite de n’importe quel point de la limite jusqu’au point central, la couleur passe de la couleur de ce point de limite au rouge.

Exemples

L’exemple suivant crée un objet PathGradientBrush basé sur un tableau de trois points qui définit un chemin triangulaire. Le code initialise également un tableau de trois objets Color . L’appel à la méthode PathGradientBrush::SetSurroundColors associe chaque couleur du tableau de couleurs au point correspondant (même index) dans le tableau de points. Une fois les couleurs d’entourage du pinceau dégradé de chemin d’accès définies, la méthode Graphics::FillRectangle utilise le pinceau de dégradé de chemin pour peindre un rectangle qui inclut le chemin triangulaire.

Un bord du triangle rendu passe progressivement du rouge au vert. Le bord suivant passe progressivement du vert au noir, et le troisième bord passe progressivement du noir au rouge. Comme le code ne définit pas la couleur du centre, la couleur du centre a la valeur par défaut noir. Lorsque vous vous déplacez le long d’une ligne droite de n’importe quel point du chemin de la limite (triangle) au point central, la couleur passe progressivement de la couleur de ce point de limite au noir.

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

   Point pts[] = {
      Point(20, 20), 
      Point(100, 20), 
      Point(100, 100)};

   Color cols[] = {
      Color(255, 255, 0, 0),  // red
      Color(255, 0, 255, 0),  // green
      Color(255, 0, 0, 0)};   // black

   INT count = 3;
   PathGradientBrush pthGrBrush(pts, 3);
   pthGrBrush.SetSurroundColors(cols, &count);
   
   graphics.FillRectangle(&pthGrBrush, 0, 0, 200, 200);
}

Configuration requise


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