PathGradientBrush Classe

Définition

Espace de noms:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

PathGradientBrush.cs

Encapsule un objet Brush qui remplit l'intérieur d'un objet GraphicsPath avec un dégradé. Cette classe ne peut pas être héritée.

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

Héritage

Object

MarshalByRefObject

Brush

PathGradientBrush

Exemples

L’exemple de code suivant montre comment créer un PathGradientBrush. Cet exemple est conçu pour être utilisé avec Windows Forms, et il nécessite l’ePaintEventArgs, qui est un paramètre de 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)

Remarques

Le dégradé de couleurs est un ombrage lisse des couleurs du point central du chemin jusqu’au bord de la limite extérieure du chemin. Les facteurs de fusion, les positions et le style affectent l’endroit où le dégradé commence et se termine, ainsi que la vitesse à laquelle il change de nuance.

Les pinceaux de dégradé de chemin n’obéissent pas à la SmoothingMode propriété de l’objet Graphics utilisé pour effectuer le dessin. Les zones remplies à l’aide d’un PathGradientBrush objet sont rendues de la même façon (alias) quel que soit le mode de lissage.

Notes

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

PathGradientBrush(GraphicsPath)	Initialise une nouvelle instance de la classe PathGradientBrush avec le chemin spécifié.
PathGradientBrush(Point[])	Initialise une nouvelle instance de la classe PathGradientBrush avec les points spécifiés.
PathGradientBrush(Point[], WrapMode)	Initialise une nouvelle instance de la classe PathGradientBrush avec les points et le mode habillage spécifiés.
PathGradientBrush(PointF[])	Initialise une nouvelle instance de la classe PathGradientBrush avec les points spécifiés.
PathGradientBrush(PointF[], WrapMode)	Initialise une nouvelle instance de la classe PathGradientBrush avec les points et le mode habillage spécifiés.

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é.
CenterColor	Obtient ou définit la couleur au centre du dégradé du tracé.
CenterPoint	Obtient ou définit le point central du dégradé du tracé.
FocusScales	Obtient ou définit le point de focus pour l'atténuation du dégradé.
InterpolationColors	Obtient ou définit un ColorBlend qui définit un dégradé linéaire de plusieurs couleurs.
Rectangle	Obtient un rectangle englobant pour ce PathGradientBrush.
SurroundColors	Obtient ou définit un tableau des couleurs qui correspondent aux points du tracé rempli par ce PathGradientBrush.
Transform	Obtient ou définit une copie de la Matrix qui définit une transformation géométrique locale pour ce PathGradientBrush.
WrapMode	Obtient ou définit un WrapMode qui indique le mode habillage pour ce PathGradientBrush.

Méthodes

Clone()	Crée une copie exacte de 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. (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)	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.
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.
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é comportant une couleur centrale et une atténuation linéaire vers une couleur environnante.
SetBlendTriangularShape(Single, Single)	Crée un dégradé comportant une couleur centrale et une atténuation linéaire vers chacune des couleurs environnantes.
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 un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.
SetSigmaBellShape(Single, Single)	Crée un pinceau dont le dégradé de couleurs change du centre vers le bord du tracé. La transition d'une couleur à une autre est basée sur une courbe ayant la forme d'une cloche.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TranslateTransform(Single, Single)	Applique la translation spécifiée à la transformation géométrique locale. Cette méthode ajoute la translation avant la transformation.
TranslateTransform(Single, Single, MatrixOrder)	Applique la translation spécifiée à la transformation géométrique locale dans l'ordre spécifié.

Voir aussi

• Guide pratique pour Create un dégradé de chemin