LinearGradientBrush ::LinearGradientBrush(constRect&,constColor&,constColor&,REAL,BOOL) (gdiplusbrush.h)
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 |