LinearGradientBrush Classe

Définition

Espace de noms:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-preview.5.24306.5

Source:

LinearGradientBrush.cs

Encapsule un Brush avec un dégradé linéaire. Cette classe ne peut pas être héritée.

public ref class LinearGradientBrush sealed : System::Drawing::Brush

public sealed class LinearGradientBrush : System.Drawing.Brush

type LinearGradientBrush = class
    inherit Brush

Public NotInheritable Class LinearGradientBrush
Inherits Brush

Héritage

Object

MarshalByRefObject

Brush

LinearGradientBrush

Exemples

L’exemple suivant crée un LinearGradientBrushhorizontal ; les composants de couleur changent linéairement à mesure que vous passez d’une coordonnée horizontale de 0 à une coordonnée horizontale de 200. Par exemple, un point dont la première coordonnée est comprise entre 0 et 200 aura un composant bleu qui se situe entre 0 et 255. Cet exemple est conçu pour une utilisation avec Windows Forms. L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite l'PaintEventArgse, qui est un paramètre de PaintEventHandler.

public void UseHorizontalLinearGradients(PaintEventArgs e)
{
    LinearGradientBrush linGrBrush = new LinearGradientBrush(
       new Point(0, 10),
       new Point(200, 10),
       Color.FromArgb(255, 255, 0, 0),   // Opaque red
       Color.FromArgb(255, 0, 0, 255));  // Opaque blue

    Pen pen = new Pen(linGrBrush);

    e.Graphics.DrawLine(pen, 0, 10, 200, 10);
    e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
    e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);
}

Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)

e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)

Remarques

Cette classe encapsule les dégradés à deux couleurs et les dégradés multicolores personnalisés.

Tous les dégradés linéaires sont définis le long d’une ligne spécifiée par la largeur d’un rectangle ou par deux points.

Par défaut, un dégradé linéaire à deux couleurs est un mélange linéaire horizontal pair entre la couleur de départ et la couleur de fin le long de la ligne spécifiée. Personnalisez le modèle de fusion à l’aide de la classe Blend, des méthodes SetSigmaBellShape ou des méthodes SetBlendTriangularShape. Personnalisez la direction du dégradé en spécifiant l’énumération LinearGradientMode ou l’angle dans le constructeur.

Utilisez la propriété InterpolationColors pour créer un dégradé multicolore.

La propriété Transform spécifie une transformation géométrique locale appliquée au dégradé.

Note

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, n’est pris en charge que sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

LinearGradientBrush(Point, Point, Color, Color)	Initialise une nouvelle instance de la classe LinearGradientBrush avec les points et couleurs spécifiés.
LinearGradientBrush(PointF, PointF, Color, Color)	Initialise une nouvelle instance de la classe LinearGradientBrush avec les points et couleurs spécifiés.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Crée une instance de la classe LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’orientation.
LinearGradientBrush(Rectangle, Color, Color, Single)	Crée une instance de la classe LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’un angle d’orientation.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Crée une instance de la classe LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’un angle d’orientation.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Crée une instance du LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’un mode d’orientation.
LinearGradientBrush(RectangleF, Color, Color, Single)	Crée une instance de la classe LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’un angle d’orientation.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Crée une instance de la classe LinearGradientBrush en fonction d’un rectangle, de couleurs de début et de fin et d’un angle d’orientation.

Propriétés

Blend	Obtient ou définit une Blend qui spécifie des positions et des facteurs qui définissent une chute personnalisée pour le dégradé.
GammaCorrection	Obtient ou définit une valeur indiquant si la correction gamma est activée pour cette LinearGradientBrush.
InterpolationColors	Obtient ou définit une ColorBlend qui définit un dégradé linéaire multicolore.
LinearColors	Obtient ou définit les couleurs de début et de fin du dégradé.
Rectangle	Obtient une région rectangulaire qui définit les points de départ et de fin du dégradé.
Transform	Obtient ou définit une Matrix de copie qui définit une transformation géométrique locale pour cette LinearGradientBrush.
WrapMode	Obtient ou définit une énumération WrapMode qui indique le mode de wrap pour cette LinearGradientBrush.

Méthodes

Clone()	Crée une copie exacte de cette LinearGradientBrush.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par cet objet Brush. (Hérité de Brush)
Dispose(Boolean)	Libère les ressources non managées utilisées par le Brush et libère éventuellement les ressources managées. (Hérité de Brush)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplie l'Matrix qui représente la transformation géométrique locale de cette LinearGradientBrush par la Matrix spécifiée en prédéfinissant la Matrixspécifiée.
MultiplyTransform(Matrix, MatrixOrder)	Multiplie la Matrix qui représente la transformation géométrique locale de cette LinearGradientBrush par la Matrix spécifiée dans l’ordre spécifié.
ResetTransform()	Réinitialise la propriété Transform à l’identité.
RotateTransform(Single)	Fait pivoter la transformation géométrique locale par la quantité spécifiée. Cette méthode précède la rotation de la transformation.
RotateTransform(Single, MatrixOrder)	Fait pivoter la transformation géométrique locale par la quantité spécifiée dans l’ordre spécifié.
ScaleTransform(Single, Single)	Met à l’échelle la transformation géométrique locale par les quantités spécifiées. Cette méthode précède la matrice de mise à l’échelle de la transformation.
ScaleTransform(Single, Single, MatrixOrder)	Met à l’échelle la transformation géométrique locale par les quantités spécifiées dans l’ordre spécifié.
SetBlendTriangularShape(Single)	Crée un dégradé linéaire avec une couleur centrale et une chute linéaire à une seule couleur aux deux extrémités.
SetBlendTriangularShape(Single, Single)	Crée un dégradé linéaire avec une couleur centrale et une chute linéaire à une seule couleur aux deux extrémités.
SetNativeBrush(IntPtr)	Dans une classe dérivée, définit une référence à un objet pinceau GDI+. (Hérité de Brush)
SetSigmaBellShape(Single)	Crée une chute dégradée basée sur une courbe en forme de cloche.
SetSigmaBellShape(Single, Single)	Crée une chute dégradée basée sur une courbe en forme de cloche.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TranslateTransform(Single, Single)	Traduit la transformation géométrique locale par les dimensions spécifiées. Cette méthode précède la traduction vers la transformation.
TranslateTransform(Single, Single, MatrixOrder)	Traduit la transformation géométrique locale par les dimensions spécifiées dans l’ordre spécifié.

Voir aussi

• Comment : créer un dégradé linéaire