LinearGradientBrush ::LinearGradientBrush(constPointF&,constPointF&,constColor&,constColor&) (gdiplusbrush.h)

Crée un objet LinearGradientBrush ::LinearGradientBrush à partir d’un ensemble de points de limites et de couleurs de limites.

Syntaxe

void LinearGradientBrush(
  [in, ref] const PointF & point1,
  [in, ref] const PointF & point2,
  [in, ref] const Color &  color1,
  [in, ref] const Color &  color2
);

Paramètres

[in, ref] point1

Type : const PointF

Référence à un objet Point qui spécifie le point de départ du dégradé. La ligne de limite de départ passe par le point de départ.

[in, ref] point2

Type : const PointF

Référence à un objet Point qui spécifie le point de fin du dégradé. La ligne limite de fin passe par 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.

Valeur de retour

None

Remarques

La « ligne directionnelle », une ligne droite imaginaire, est définie par le point de départ, point1, et le point de fin, point2. 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 limite de départ et qui passe par le point de fin. 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.

Exemples

L’exemple suivant crée un pinceau de dégradé linéaire à partir d’un ensemble de points limites et de couleurs de limites. Le code utilise ensuite le pinceau pour peindre l’intérieur d’un rectangle.

VOID Example_Construct02(HDC hdc)
{
   Graphics myGraphics(hdc);

   LinearGradientBrush linGrBrush(
      PointF(0.8f, 1.6f),
      PointF(3.0f, 2.4f),
      Color(255, 255, 0, 0),   // red
      Color(255, 0, 0, 255));  // blue

   myGraphics.SetPageUnit(UnitInch);
   myGraphics.FillRectangle(&linGrBrush, 0, 0, 4, 3); 
}

Configuration requise

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

Color

LinearGradientBrush

Rect