LinearGradientBrush Classe

Définition

Espace de noms:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

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 une valeur horizontale LinearGradientBrush; les composants de couleur changent linéairement lorsque 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 à mi-chemin entre 0 et 200 aura un composant bleu qui est à mi-chemin entre 0 et 255. Cet exemple est conçu pour être utilisé avec Windows Forms. L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite le PaintEventArgseparamètre , 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 à la fois des dégradés bicolores et des dégradés multicolores personnalisés.

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

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

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

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

Remarque

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est uniquement pris en charge sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes entraîne des avertissements au moment de la compilation et des exceptions au moment de l’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 nouvelle instance de la classe LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et de l'orientation.
LinearGradientBrush(Rectangle, Color, Color, Single)	Crée une nouvelle instance de la classe LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et d'un angle d'orientation.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Crée une nouvelle instance de la classe LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et d'un angle d'orientation.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Crée une nouvelle instance de LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et d'un mode d'orientation.
LinearGradientBrush(RectangleF, Color, Color, Single)	Crée une nouvelle instance de la classe LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et d'un angle d'orientation.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Crée une nouvelle instance de la classe LinearGradientBrush sur la base d'un rectangle, des couleurs de début et de fin et d'un angle d'orientation.

Propriétés

Blend	Obtient ou définit un Blend qui spécifie les positions et les facteurs définissant une atténuation personnalisée pour le dégradé.
GammaCorrection	Obtient ou définit une valeur indiquant si la correction du gamma est activée pour ce LinearGradientBrush.
InterpolationColors	Obtient ou définit un ColorBlend qui définit un dégradé linéaire de plusieurs couleurs.
LinearColors	Obtient ou définit les couleurs de début et de fin du dégradé.
Rectangle	Obtient une zone rectangulaire qui définit les points de début et de fin du dégradé.
Transform	Obtient ou définit une copie Matrix qui définit une transformation géométrique locale pour ce LinearGradientBrush.
WrapMode	Obtient ou définit une énumération WrapMode qui indique le mode habillage pour ce LinearGradientBrush.

Méthodes

Clone()	Crée une copie exacte de LinearGradientBrush.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de 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 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()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	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 Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
MultiplyTransform(Matrix)	Multiplie le Matrix qui représente la transformation géométrique locale de ce LinearGradientBrush par le Matrix spécifié en ajoutant au début le Matrix spécifié.
MultiplyTransform(Matrix, MatrixOrder)	Multiplie le Matrix qui représente la transformation géométrique locale de ce LinearGradientBrush par le Matrix spécifié dans l'ordre donné.
ResetTransform()	Rétablit l'identité de la propriété Transform.
RotateTransform(Single)	Fait pivoter la transformation géométrique locale conformément à la valeur spécifiée. Cette méthode ajoute la rotation avant la transformation.
RotateTransform(Single, MatrixOrder)	Fait pivoter la transformation géométrique locale conformément à la valeur et à l'ordre spécifiés.
ScaleTransform(Single, Single)	Effectue une mise à l'échelle de la transformation géométrique locale selon les valeurs spécifiées. Cette méthode ajoute la matrice de mise à l'échelle avant la transformation.
ScaleTransform(Single, Single, MatrixOrder)	Effectue une mise à l'échelle de la transformation géométrique locale conformément aux valeurs et à l'ordre spécifiés.
SetBlendTriangularShape(Single)	Crée un dégradé linéaire avec une couleur centrale et une variation décroissante linéaire vers une couleur unique aux deux extrémités.
SetBlendTriangularShape(Single, Single)	Crée un dégradé linéaire avec une couleur centrale et une variation décroissante linéaire vers une couleur unique 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 variation décroissante de dégradé basée sur une courbe en forme de cloche.
SetSigmaBellShape(Single, Single)	Crée une variation décroissante de dégradé 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)	Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées. Cette méthode ajoute la translation avant la transformation.
TranslateTransform(Single, Single, MatrixOrder)	Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre donné.

Voir aussi

• Guide pratique pour créer un dégradé linéaire