PathGradientBrush Class

Definition

Encapsule un objet Brush qui remplit l'intérieur d'un objet GraphicsPath avec un dégradé.Encapsulates a Brush object that fills the interior of a GraphicsPath object with a gradient. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class PathGradientBrush sealed : System::Drawing::Brush
public sealed class PathGradientBrush : System.Drawing.Brush
type PathGradientBrush = class
    inherit Brush
Public NotInheritable Class PathGradientBrush
Inherits Brush
Inheritance
PathGradientBrush

Examples

L’exemple de code suivant montre comment créer un PathGradientBrush.The following code example shows how to create a PathGradientBrush. Cet exemple est conçu pour être utilisé avec Windows Forms, et il requiert le PaintEventArgs e, qui est un paramètre de PaintEventHandler.This example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of PaintEventHandler.

public void FillEllipseWithPathGradient(PaintEventArgs e)
{
    // Create a path that consists of a single ellipse.
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(0, 0, 140, 70);

    // Use the path to construct a brush.
    PathGradientBrush pthGrBrush = new PathGradientBrush(path);

    // Set the color at the center of the path to blue.
    pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255);

    // Set the color along the entire boundary 
    // of the path to aqua.
    Color[] colors = { Color.FromArgb(255, 0, 255, 255) };
    pthGrBrush.SurroundColors = colors;

    e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70);
}
' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(0, 0, 140, 70)

' Use the path to construct a brush.
Dim pthGrBrush As New PathGradientBrush(path)

' Set the color at the center of the path to blue.
pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255)

' Set the color along the entire boundary 
' of the path to aqua.
Dim colors As Color() = {Color.FromArgb(255, 0, 255, 255)}
pthGrBrush.SurroundColors = colors

e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70)

Remarks

Le dégradé de couleur est un ombrage lissé des couleurs du point central du tracé vers le bord extérieur du tracé.The color gradient is a smooth shading of colors from the center point of the path to the outside boundary edge of the path. Les facteurs de fusion, les positions et le style affectent l’emplacement de début et de fin du dégradé, et la vitesse à laquelle il change de teinte.Blend factors, positions, and style affect where the gradient starts and ends, and how fast it changes shade.

Les pinceaux de dégradé de tracés n’obéissent pas à la propriété SmoothingMode de l’objet Graphics utilisé pour effectuer le dessin.Path gradient brushes do not obey the SmoothingMode property of the Graphics object used to do the drawing. Les zones remplies à l’aide d’un objet PathGradientBrush sont rendues de la même façon (avec un alias) quel que soit le mode de lissage.Areas filled using a PathGradientBrush object are rendered the same way (aliased) regardless of the smoothing mode.

Constructors

PathGradientBrush(GraphicsPath)

Initialise une nouvelle instance de la classe PathGradientBrush avec le chemin spécifié.Initializes a new instance of the PathGradientBrush class with the specified path.

PathGradientBrush(Point[])

Initialise une nouvelle instance de la classe PathGradientBrush avec les points spécifiés.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(Point[], WrapMode)

Initialise une nouvelle instance de la classe PathGradientBrush avec les points et le mode habillage spécifiés.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

PathGradientBrush(PointF[])

Initialise une nouvelle instance de la classe PathGradientBrush avec les points spécifiés.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(PointF[], WrapMode)

Initialise une nouvelle instance de la classe PathGradientBrush avec les points et le mode habillage spécifiés.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Properties

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.

CenterColor

Obtient ou définit la couleur au centre du dégradé du tracé.Gets or sets the color at the center of the path gradient.

CenterPoint

Obtient ou définit le point central du dégradé du tracé.Gets or sets the center point of the path gradient.

FocusScales

Obtient ou définit le point de focus pour l'atténuation du dégradé.Gets or sets the focus point for the gradient falloff.

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.

Rectangle

Obtient un rectangle englobant pour ce PathGradientBrush.Gets a bounding rectangle for this PathGradientBrush.

SurroundColors

Obtient ou définit un tableau des couleurs qui correspondent aux points du tracé rempli par ce PathGradientBrush.Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush fills.

Transform

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

WrapMode

Obtient ou définit un WrapMode qui indique le mode habillage pour ce PathGradientBrush.Gets or sets a WrapMode that indicates the wrap mode for this PathGradientBrush.

Methods

Clone()

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

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

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

(Inherited from 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.

(Inherited from Brush)
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()

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

(Inherited from 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.

(Inherited from MarshalByRefObject)
GetType()

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

(Inherited from 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.

(Inherited from MarshalByRefObject)
MemberwiseClone()

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

(Inherited from Object)
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)

Met à jour la matrice de transformation du pinceau avec le résultat obtenu après la multiplication de cette dernière par une autre matrice.Updates the brush's transformation matrix with the product of brush's transformation matrix multiplied by another matrix.

MultiplyTransform(Matrix, MatrixOrder)

Met à jour la matrice de transformation du pinceau avec le résultat obtenu après la multiplication de cette dernière par une autre matrice.Updates the brush's transformation matrix with the product of the brush's transformation matrix multiplied by another matrix.

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é comportant une couleur centrale et une atténuation linéaire vers une couleur environnante.Creates a gradient with a center color and a linear falloff to one surrounding color.

SetBlendTriangularShape(Single, Single)

Crée un dégradé comportant une couleur centrale et une atténuation linéaire vers chacune des couleurs environnantes.Creates a gradient with a center color and a linear falloff to each surrounding color.

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)

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.The transition from one color to another is based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.The transition from one color to another is 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.

(Inherited from Object)
TranslateTransform(Single, Single)

Applique la translation spécifiée à la transformation géométrique locale.Applies the specified translation to the local geometric transform. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

Applique la translation spécifiée à la transformation géométrique locale dans l'ordre spécifié.Applies the specified translation to the local geometric transform in the specified order.

Applies to

See also