LinearGradientBrush Classe

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

LinearGradientBrush.cs

Incapsula una classe Brush con una sfumatura lineare. La classe non può essere ereditata.

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

Ereditarietà

Object

MarshalByRefObject

Brush

LinearGradientBrush

Esempio

Nell'esempio seguente viene creato un oggetto orizzontale LinearGradientBrush. I componenti di colore cambiano in modo lineare quando si passa da una coordinata orizzontale pari a 0 a una coordinata orizzontale di 200. Ad esempio, un punto la cui prima coordinata è a metà tra 0 e 200 avrà un componente blu a metà tra 0 e 255. Questo esempio è progettato per l'uso con Windows Forms. L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro di 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)

Commenti

Questa classe incapsula sia sfumature a due colori che sfumature multicolore personalizzate.

Tutte le sfumature lineari vengono definite lungo una linea specificata dalla larghezza di un rettangolo o da due punti.

Per impostazione predefinita, una sfumatura lineare a due colori è una fusione lineare uniforme dal colore iniziale al colore finale lungo la linea specificata. Personalizzare il modello blend usando la Blend classe , i SetSigmaBellShape metodi o i SetBlendTriangularShape metodi . Personalizzare la direzione della sfumatura specificando l'enumerazione LinearGradientMode o l'angolo nel costruttore.

Utilizzare la InterpolationColors proprietà per creare una sfumatura multicolore.

La Transform proprietà specifica una trasformazione geometrica locale applicata alla sfumatura.

Nota

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

Costruttori

LinearGradientBrush(Point, Point, Color, Color)	Inizializza una nuova istanza della classe LinearGradientBrush con i punti e i colori specificati.
LinearGradientBrush(PointF, PointF, Color, Color)	Inizializza una nuova istanza della classe LinearGradientBrush con i punti e i colori specificati.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e l'orientamento.
LinearGradientBrush(Rectangle, Color, Color, Single)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e un angolo di orientamento.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e un angolo di orientamento.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e una modalità di orientamento.
LinearGradientBrush(RectangleF, Color, Color, Single)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e un angolo di orientamento.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Crea una nuova istanza della classe LinearGradientBrush basata su un rettangolo, il colore iniziale e quello finale e un angolo di orientamento.

Proprietà

Blend	Ottiene o imposta una classe Blend che specifica le posizioni e i fattori che definiscono un'interruzione personalizzata per la sfumatura.
GammaCorrection	Ottiene o imposta un valore che indica se la correzione gamma è attivata per questa classe LinearGradientBrush.
InterpolationColors	Ottiene o imposta una classe ColorBlend che definisce una sfumatura lineare a più colori.
LinearColors	Ottiene o imposta il colore iniziale e quello finale della sfumatura.
Rectangle	Ottiene un'area rettangolare che definisce il punto iniziale e quello finale della sfumatura.
Transform	Ottiene o imposta una copia Matrix che definisce una trasformazione geometrica locale per questo oggetto LinearGradientBrush.
WrapMode	Ottiene o imposta un'enumerazione WrapMode che indica la modalità A capo automatico per questo oggetto LinearGradientBrush.

Metodi

Clone()	Crea una copia esatta di questo LinearGradientBrush.
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()	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()	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)	Moltiplica la classe Matrix che rappresenta la trasformazione geometrica locale di questa classe LinearGradientBrush per la classe Matrix specificata anteponendo la classe Matrix specificata.
MultiplyTransform(Matrix, MatrixOrder)	Moltiplica la classe Matrix che rappresenta la trasformazione geometrica locale di questa classe LinearGradientBrush per la classe Matrix specificata nell'ordine indicato.
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 lineare con un colore centrale e un'interruzione lineare in un solo colore su entrambe le estremità.
SetBlendTriangularShape(Single, Single)	Crea una sfumatura lineare con un colore centrale e un'interruzione lineare in un solo colore su entrambe le estremità.
SetNativeBrush(IntPtr)	In una classe derivata imposta un riferimento a un oggetto pennello GDI+. (Ereditato da Brush)
SetSigmaBellShape(Single)	Crea un'interruzione della sfumatura in base a una curva a campana.
SetSigmaBellShape(Single, Single)	Crea un'interruzione della sfumatura in base a una curva a campana.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TranslateTransform(Single, Single)	Sottopone a traslazione la trasformazione geometrica locale in base alle dimensioni specificate. Questo metodo antepone la traslazione alla trasformazione.
TranslateTransform(Single, Single, MatrixOrder)	Sottopone a traslazione la trasformazione geometrica locale in base alle dimensioni specificate nell'ordine indicato.

Vedi anche

• Procedura: Create una sfumatura lineare