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

Article
02/27/2024

La méthode PathGradientBrush ::SetInterpolationColors définit les couleurs prédéfinies et les positions de fusion de ce pinceau dégradé de chemin.

Syntaxe

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

Paramètres

[in] presetColors

Type : const Color*

Pointeur vers un tableau d’objets Color qui spécifie les couleurs d’interpolation pour le dégradé. Une couleur d’un index donné dans le tableau presetColors correspond à la position de fusion de ce même index dans le tableau blendPositions .

[in] blendPositions

Type : REAL*

Pointeur vers un tableau qui spécifie les positions de fusion. Chaque position de fusion est un nombre compris entre 0 et 1, où 0 indique la limite du dégradé et 1 indique le point central. Une position de fusion comprise entre 0 et 1 spécifie l’ensemble de tous les points qui représentent une certaine fraction de la distance entre la limite et le point central. Par exemple, une position de fusion de 0,7 spécifie l’ensemble de tous les points qui se trouvent à 70 % du chemin entre la limite et le point central.

[in] count

Type : INT

Entier qui spécifie le nombre d’objets Color dans le tableau presetColors . Il s’agit du même nombre d’éléments dans le tableau blendPositions .

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

Un pinceau dégradé de chemin simple a deux couleurs : une couleur de limite et une couleur centrale. Lorsque vous peignez avec un tel pinceau, la couleur passe progressivement de la couleur de la limite à la couleur du centre à mesure que vous passez du chemin de la limite au point central. Vous pouvez créer un dégradé plus complexe en spécifiant un tableau de couleurs prédéfinies et un tableau de positions de fusion.

Exemples

L’exemple suivant crée un objet PathGradientBrush basé sur un chemin triangulaire. La méthode PathGradientBrush ::SetInterpolationColors définit les couleurs prédéfinies du pinceau sur le rouge, le bleu et l’aqua, et définit les positions de fusion sur 0, 0, 4 et 1. La méthode Graphics ::FillRectangle utilise le pinceau dégradé de chemin pour peindre un rectangle qui contient le chemin triangulaire.

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

   Point points[] = {Point(100, 0), Point(200, 200), Point(0, 200)};
   PathGradientBrush pthGrBrush(points, 3);

   Color col[] = {
      Color(255, 255, 0, 0),     // red
      Color(255, 0, 0, 255),     // blue
      Color(255, 0, 255, 255)};  // aqua

   REAL pos[] = {
      0.0f,    // red at the boundary
      0.4f,    // blue 40 percent of the way from the boundary to the center
      1.0f};   // aqua at the center

   pthGrBrush.SetInterpolationColors(col, pos, 3);
   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