LinearGradientBrush LinearGradientBrush LinearGradientBrush LinearGradientBrush Class

Définition

Encapsule un Brush avec un dégradé linéaire.Encapsulates a Brush with a linear gradient. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
LinearGradientBrushLinearGradientBrushLinearGradientBrushLinearGradientBrush

Exemples

L’exemple suivant crée un horizontal LinearGradientBrush; les composants de couleur changent linéairement lorsque vous passez de la coordonnée horizontale de 0 à une coordonnée horizontale de 200.The following example creates a horizontal LinearGradientBrush; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. Par exemple, un point dont la première coordonnée se trouve à mi-chemin entre 0 et 200 aura un composant bleu qui se trouve à mi-chemin entre 0 et 255.For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. Cet exemple est conçu pour une utilisation avec Windows Forms.This example is designed for use with Windows Forms. L’exemple de code suivant est conçu pour une utilisation avec Windows Forms et nécessite le PaintEventArgs e, qui est un paramètre de PaintEventHandler.The following code example is designed for use with Windows Forms, and it requires the PaintEventArgse, which is a parameter of 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 des dégradés de deux couleurs et des dégradés multicolores personnalisés.This class encapsulates both two-color gradients and custom multicolor gradients.

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.All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

Par défaut, un dégradé linéaire de deux couleurs est un mélange linéaire horizontal uniforme à partir de la couleur de début pour la couleur de fin le long de la ligne spécifiée.By default, a two-color linear gradient is an even horizontal linear blend from the starting color to the ending color along the specified line. Personnaliser le modèle de blend à l’aide de la Blend (classe), le SetSigmaBellShape méthodes, ou le SetBlendTriangularShape méthodes.Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Personnalisez l’orientation du dégradé en spécifiant le LinearGradientMode énumération ou l’angle dans le constructeur.Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

Utilisez le InterpolationColors propriété pour créer un dégradé multicolore.Use the InterpolationColors property to create a multicolor gradient.

Le Transform propriété spécifie une transformation géométrique locale appliquée au dégradé.The Transform property specifies a local geometric transform applied to the gradient.

Constructeurs

LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color)

Initialise une nouvelle instance de la classe LinearGradientBrush avec les points et couleurs spécifiés.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color)

Initialise une nouvelle instance de la classe LinearGradientBrush avec les points et couleurs spécifiés.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) 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.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) 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.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) 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.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) 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.Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.

LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) 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.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) 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.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

Propriétés

Blend Blend Blend 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é.Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

GammaCorrection GammaCorrection GammaCorrection GammaCorrection

Obtient ou définit une valeur indiquant si la correction du gamma est activée pour ce LinearGradientBrush.Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.

InterpolationColors InterpolationColors InterpolationColors InterpolationColors

Obtient ou définit un ColorBlend qui définit un dégradé linéaire de plusieurs couleurs.Gets or sets a ColorBlend that defines a multicolor linear gradient.

LinearColors LinearColors LinearColors LinearColors

Obtient ou définit les couleurs de début et de fin du dégradé.Gets or sets the starting and ending colors of the gradient.

Rectangle Rectangle Rectangle Rectangle

Obtient une zone rectangulaire qui définit les points de début et de fin du dégradé.Gets a rectangular region that defines the starting and ending points of the gradient.

Transform Transform Transform Transform

Obtient ou définit une copie Matrix qui définit une transformation géométrique locale pour ce LinearGradientBrush.Gets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.

WrapMode WrapMode WrapMode WrapMode

Obtient ou définit une énumération WrapMode qui indique le mode habillage pour ce LinearGradientBrush.Gets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.

Méthodes

Clone() Clone() Clone() Clone()

Crée une copie exacte de LinearGradientBrush.Creates an exact copy of this LinearGradientBrush.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par cet objet Brush.Releases all resources used by this Brush object.

(Inherited from Brush)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par Brush et libère éventuellement les ressources managées.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Inherited from Brush)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) 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é.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) 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é.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

Rétablit l'identité de la propriété Transform.Resets the Transform property to identity.

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

Fait pivoter la transformation géométrique locale conformément à la valeur spécifiée.Rotates the local geometric transform by the specified amount. Cette méthode ajoute la rotation avant la transformation.This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

Fait pivoter la transformation géométrique locale conformément à la valeur et à l'ordre spécifiés.Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single)

Effectue une mise à l'échelle de la transformation géométrique locale selon les valeurs spécifiées.Scales the local geometric transform by the specified amounts. Cette méthode ajoute la matrice de mise à l'échelle avant la transformation.This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) 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.Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) 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.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) 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.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr)

Dans une classe dérivée, définit une référence à un objet brush GDI+GDI+.In a derived class, sets a reference to a GDI+GDI+ brush object.

(Inherited from Brush)
SetSigmaBellShape(Single) SetSigmaBellShape(Single) SetSigmaBellShape(Single) SetSigmaBellShape(Single)

Crée une variation décroissante de dégradé basée sur une courbe en forme de cloche.Creates a gradient falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single)

Crée une variation décroissante de dégradé basée sur une courbe en forme de cloche.Creates a gradient falloff based on a bell-shaped curve.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées.Translates the local geometric transform by the specified dimensions. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

Effectue la translation de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre donné.Translates the local geometric transform by the specified dimensions in the specified order.

S’applique à

Voir aussi