PathGradientBrush Classe

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Assembly:

System.Drawing.dll

Incapsula un oggetto Brush che riempie la parte interna di un oggetto GraphicsPath con una sfumatura. La classe non può essere ereditata.

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

Ereditarietà

Object

MarshalByRefObject

Brush

PathGradientBrush

Esempio

Nell'esempio di codice seguente viene illustrato come creare un PathGradientBrushoggetto . Questo esempio è progettato per l'uso con Windows Forms e richiede l'ePaintEventArgs, ovvero un parametro di 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)

Commenti

La sfumatura del colore è una sfumatura di colori uniforme dal punto centrale del percorso al bordo esterno del limite del percorso. I fattori di fusione, le posizioni e lo stile influiscono sulla posizione in cui inizia e termina la sfumatura e il modo in cui cambia la sfumatura.

I pennelli sfumatura percorso non obbediscono alla SmoothingMode proprietà dell'oggetto Graphics usato per eseguire il disegno. Le aree riempite usando un PathGradientBrush oggetto vengono visualizzate allo stesso modo (aliased) indipendentemente dalla modalità di smoothing.

Nota

In .NET 6 e versioni successive il pacchetto System.Drawing.Common,che include questo tipo, è supportato solo nei Windows operativi. L'uso di questo tipo nelle app multipiattaforma genera avvisi in fase di compilazione ed eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportatosolo in Windows .

Costruttori

PathGradientBrush(GraphicsPath)	Inizializza una nuova istanza della classe PathGradientBrush con il percorso specificato.
PathGradientBrush(Point[])	Inizializza una nuova istanza della classe PathGradientBrush con i punti specificati.
PathGradientBrush(Point[], WrapMode)	Inizializza una nuova istanza della classe PathGradientBrush con i punti specificati e la modalità A capo automatico.
PathGradientBrush(PointF[])	Inizializza una nuova istanza della classe PathGradientBrush con i punti specificati.
PathGradientBrush(PointF[], WrapMode)	Inizializza una nuova istanza della classe PathGradientBrush con i punti specificati e la modalità A capo automatico.

Proprietà

Blend	Ottiene o imposta una classe Blend che specifica le posizioni e i fattori che definiscono un'interruzione personalizzata per la sfumatura.
CenterColor	Ottiene o imposta il colore al centro della sfumatura del percorso.
CenterPoint	Ottiene o imposta il punto centrale della sfumatura del percorso.
FocusScales	Ottiene o imposta il punto di attivazione dell'interruzione della sfumatura.
InterpolationColors	Ottiene o imposta una classe ColorBlend che definisce una sfumatura lineare a più colori.
Rectangle	Ottiene un rettangolo di delimitazione per questa classe PathGradientBrush.
SurroundColors	Ottiene o imposta una matrice di colori che corrisponde ai punti del percorso che questa classe PathGradientBrush riempie.
Transform	Ottiene o imposta una copia dell'oggetto Matrix che definisce una trasformazione geometrica locale per questo oggetto PathGradientBrush.
WrapMode	Ottiene o imposta un'enumerazione WrapMode che indica la modalità A capo automatico per questa classe PathGradientBrush.

Metodi

Clone()	Crea una copia esatta di questo PathGradientBrush.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate dall'oggetto Brush. (Ereditato da Brush)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Brush e, facoltativamente, le risorse gestite. (Ereditato da Brush)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleta. Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleta. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
MultiplyTransform(Matrix)	Aggiorna la matrice di trasformazione del pennello con il prodotto tra la matrice di trasformazione del pennello e un'altra matrice.
MultiplyTransform(Matrix, MatrixOrder)	Aggiorna la matrice di trasformazione del pennello con il prodotto tra la matrice di trasformazione del pennello e un'altra matrice.
ResetTransform()	Reimposta la proprietà Transform sull'identità.
RotateTransform(Single)	Ruota la trasformazione geometrica locale in base al valore specificato. Questo metodo antepone la rotazione alla trasformazione.
RotateTransform(Single, MatrixOrder)	Ruota la trasformazione geometrica locale in base al valore specificato nell'ordine indicato.
ScaleTransform(Single, Single)	Modifica le proporzioni della trasformazione geometrica locale in base ai valori specificati. Questo metodo antepone la matrice per la modifica delle proporzioni alla trasformazione.
ScaleTransform(Single, Single, MatrixOrder)	Modifica le proporzioni della trasformazione geometrica locale in base ai valori specificati nell'ordine indicato.
SetBlendTriangularShape(Single)	Crea una sfumatura con un colore centrale e un'interruzione lineare su un colore circostante.
SetBlendTriangularShape(Single, Single)	Crea una sfumatura con un colore centrale e un'interruzione lineare su ciascun colore circostante.
SetNativeBrush(IntPtr)	In una classe derivata imposta un riferimento a un oggetto pennello GDI+. (Ereditato da Brush)
SetSigmaBellShape(Single)	Crea un pennello per le sfumature che cambia colore a partire dal centro del percorso fino al suo limite. Il cambiamento da un colore all'altro si basa su una curva a campana.
SetSigmaBellShape(Single, Single)	Crea un pennello per le sfumature che cambia colore a partire dal centro del percorso fino al suo limite. Il cambiamento da un colore all'altro si basa su una curva a campana.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TranslateTransform(Single, Single)	Applica la traslazione specificata alla trasformazione geometrica locale. Questo metodo antepone la traslazione alla trasformazione.
TranslateTransform(Single, Single, MatrixOrder)	Applica la traslazione specificata alla trasformazione geometrica locale nell'ordine indicato.

Vedi anche

• Procedura: Creare una sfumatura di percorso