Partage via


PathGradientBrush Classe

Définition

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
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()
Obsolète.

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()
Obsolète.

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é.

S’applique à

Voir aussi