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

Article
08/23/2023

La méthode LinearGradientBrush::GetInterpolationColors obtient les couleurs actuellement définies pour être interpolées pour ce pinceau de dégradé linéaire et leurs positions de fusion correspondantes.

Syntaxe

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

Paramètres

[out] presetColors

Type : Couleur*

Pointeur vers un tableau qui reçoit les couleurs. Une couleur d’un index donné dans le tableau presetColors correspond à la position de fusion de ce même index dans le tableau blendPositions .

[out] blendPositions

Type : REAL*

Pointeur vers un tableau qui reçoit les positions de fusion. Chaque nombre du tableau indique un pourcentage de la distance entre la limite de début 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. Une position de fusion entre 0,0 et 1,0 indique une 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 . Avant d’appeler la méthode LinearGradientBrush::GetInterpolationColors d’un objet LinearGradientBrush , appelez la méthode LinearGradientBrush::GetInterpolationColorCount de ce même objet LinearGradientBrush pour déterminer le nombre actuel de couleurs. Le nombre de positions de fusion récupérées est identique au nombre de couleurs récupérées.

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 .

Spécifications


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	gdiplusbrush.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll