LinearGradientBrush ::LinearGradientBrush(constRect&,constColor&,constColor&,REAL,BOOL) (gdiplusbrush.h)

Article
02/26/2024

Crée un objet LinearGradientBrush ::LinearGradientBrush à partir d’un rectangle et d’un angle de direction.

Syntaxe

void LinearGradientBrush(
  [in, ref] const Rect &  rect,
  [in, ref] const Color & color1,
  [in, ref] const Color & color2,
  [in]      REAL          angle,
  [in]      BOOL          isAngleScalable
);

Paramètres

[in, ref] rect

Type : const Rect

Référence à un rectangle qui spécifie les points de début et de fin du dégradé. Le coin supérieur gauche du rectangle est le point de départ. Le coin inférieur droit est le point de fin.

[in, ref] color1

Type : couleur const

Référence à un objet Color qui spécifie la couleur au niveau de la ligne limite de départ de ce pinceau de dégradé linéaire.

[in, ref] color2

Type : couleur const

Référence à un objet Color qui spécifie la couleur à la ligne limite de fin de ce pinceau de dégradé linéaire.

[in] angle

Type : REAL

Nombre réel qui, si isAngleScalable a la valeur TRUE, spécifie l’angle de base à partir duquel l’angle de la ligne directionnelle est calculé, ou qui, si isAngleScalable a la valeur FALSE, spécifie l’angle de la ligne directionnelle. L’angle est mesuré en haut du rectangle spécifié par rect et doit être en degrés. Le dégradé suit la ligne directionnelle.

[in] isAngleScalable

Type : BOOL

Valeur booléenne qui spécifie si l’angle est évolutif. Si isAngleScalable a la valeur TRUE, l’angle de la ligne directionnelle est évolutif ; sinon, l’angle n’est pas évolutif.

Valeur de retour

None

Remarques

La « ligne directionnelle », une ligne droite imaginaire, est définie par le point de départ (coin supérieur gauche du rectangle rect) et l’angle. La limite de départ du dégradé est une ligne droite perpendiculaire à la ligne directionnelle et qui passe par le point de départ. La limite de fin du dégradé est une ligne droite qui est parallèle à la ligne de limite de départ et qui passe par le point de fin (coin inférieur droit du rectangle rect). La couleur de dégradé est constante le long des lignes qui sont parallèles aux lignes limites. Le dégradé passe progressivement de la couleur de début à la couleur de fin le long de la ligne directionnelle.

Si isAngleScalable a la valeur TRUE, l’angle de base est mis à l’échelle pour produire l’angle de la ligne directionnelle :

ß = arctan( (largeur/hauteur) tan(ø) )

où ß est le nouvel angle de la ligne directionnelle ; largeur et hauteur sont les dimensions du rectangle rect ; et ø est l’angle d’angle de base. Cette relation n’est valide que si l’angle est inférieur à 90 degrés.

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

Voir aussi

LinearGradientBrush

Partager via