Méthode LinearGradientBrush ::SetInterpolationColors (gdiplusbrush.h)

La méthode LinearGradientBrush ::SetInterpolationColors définit les couleurs à interpoler pour ce pinceau de dégradé linéaire et leurs positions de fusion correspondantes.

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écifient les couleurs à interpoler pour ce pinceau de dégradé linéaire. 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 : const REAL*

Pointeur vers un tableau de nombres réels qui spécifient les positions de fusion. Chaque nombre dans le tableau spécifie un pourcentage de la distance entre la limite de départ et la limite de fin et se trouve dans la plage comprise entre 0,0 et 1,0, où 0,0 indique la limite de début du dégradé et 1,0 indique la limite de fin. Il doit y avoir au moins deux positions spécifiées : la première position, qui est toujours 0,0f, et la dernière position, qui est toujours 1.0f. Sinon, le comportement n’est pas défini. Une position de fusion entre 0,0 et 1,0 indique la ligne, parallèle aux lignes limites, qui est une certaine fraction de la distance entre la limite de départ et la limite de fin. Par exemple, une position de fusion de 0,7 indique la ligne qui correspond à 70 % de la distance entre la limite de départ et la limite de fin. La couleur est constante sur les lignes parallèles aux lignes limites.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments 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 .

Configuration requise

Voir aussi

Pinceaux et formes remplies

Color

Création d’un dégradé linéaire

Remplissage d’une forme avec un dégradé de couleur

LinearGradientBrush

LinearGradientBrush ::GetInterpolationColors