LinearGradientBrush Classe

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
LinearGradientBrush

Exemples

L’exemple suivant crée un horizontal LinearGradientBrush ; les composants de couleur changent de manière linéaire à mesure que vous passez d’une 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 est à 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 être utilisé avec Windows Forms.This example is designed for use with Windows Forms. L’exemple de code suivant est conçu pour être utilisé 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 les dégradés à deux couleurs et les dégradés multicolors 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 de 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 en deux couleurs est une fusion linéaire horizontale de la couleur de début à 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. Personnalisez le modèle de fusion à l’aide de la Blend classe, des SetSigmaBellShape méthodes ou des SetBlendTriangularShape méthodes.Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Personnalisez le sens du dégradé en spécifiant l' 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 la InterpolationColors propriété pour créer un dégradé multicolore.Use the InterpolationColors property to create a multicolor gradient.

La 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)

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)

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)

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)

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)

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)

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)

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)

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

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

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

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

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

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

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

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()

Crée une copie exacte de LinearGradientBrush.Creates an exact copy of this 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

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

(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.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Hérité de Brush)
Equals(Object)

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

(Hérité de Object)
GetHashCode()

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

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

(Hérité de MarshalByRefObject)
GetType()

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

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

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

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

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

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()

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

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)

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)

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)

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)

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)

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)

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.

(Hérité de Brush)
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)

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()

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

(Hérité de Object)
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)

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