LinearGradientBrush Classe

Definizione

Spazio dei nomi:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-preview.5.24306.5

Origine:

LinearGradientBrush.cs

Incapsula un Brush con una sfumatura lineare. Questa 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 LinearGradientBrushorizzontale ; 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à strada tra 0 e 200 avrà un componente blu che si trova a metà strada tra 0 e 255. Questo esempio è progettato per l'uso con Windows Form. L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede l'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 le sfumature a due colori e le sfumature colorate 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 sfumatura lineare anche orizzontale dal colore iniziale al colore finale lungo la linea specificata. Personalizzare il modello di fusione usando la classe Blend, i metodi SetSigmaBellShape o i metodi SetBlendTriangularShape. Personalizzare la direzione della sfumatura specificando l'enumerazione LinearGradientMode o l'angolo nel costruttore.

Utilizzare la proprietà InterpolationColors per creare una sfumatura multicolore.

La proprietà Transform 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 in fase di esecuzione. 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 in base a un rettangolo, colori iniziali e finali e orientamento.
LinearGradientBrush(Rectangle, Color, Color, Single)	Crea una nuova istanza della classe LinearGradientBrush in base a un rettangolo, colori iniziali e finali e un angolo di orientamento.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Crea una nuova istanza della classe LinearGradientBrush in base a un rettangolo, colori iniziali e finali e un angolo di orientamento.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Crea una nuova istanza del LinearGradientBrush in base a un rettangolo, a colori iniziali e finali e a una modalità di orientamento.
LinearGradientBrush(RectangleF, Color, Color, Single)	Crea una nuova istanza della classe LinearGradientBrush in base a un rettangolo, colori iniziali e finali e un angolo di orientamento.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Crea una nuova istanza della classe LinearGradientBrush in base a un rettangolo, colori iniziali e finali e un angolo di orientamento.

Proprietà

Blend	Ottiene o imposta un Blend che specifica posizioni e fattori che definiscono un falloff personalizzato per la sfumatura.
GammaCorrection	Ottiene o imposta un valore che indica se la correzione gamma è abilitata per questo LinearGradientBrush.
InterpolationColors	Ottiene o imposta un ColorBlend che definisce una sfumatura lineare multicolore.
LinearColors	Ottiene o imposta i colori iniziali e finali della sfumatura.
Rectangle	Ottiene un'area rettangolare che definisce i punti iniziale e finale della sfumatura.
Transform	Ottiene o imposta una copia Matrix che definisce una trasformazione geometrica locale per questo LinearGradientBrush.
WrapMode	Ottiene o imposta un'enumerazione WrapMode che indica la modalità di wrapping per questo LinearGradientBrush.

Metodi

Clone()	Crea una copia esatta di questo LinearGradientBrush.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da questo oggetto Brush. (Ereditato da Brush)
Dispose(Boolean)	Rilascia le risorse non gestite usate dal Brush e, facoltativamente, rilascia 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()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
MultiplyTransform(Matrix)	Moltiplica il Matrix che rappresenta la trasformazione geometrica locale di questo LinearGradientBrush dall'Matrix specificato anteponendo il Matrixspecificato.
MultiplyTransform(Matrix, MatrixOrder)	Moltiplica il Matrix che rappresenta la trasformazione geometrica locale di questo LinearGradientBrush in base al Matrix specificato nell'ordine specificato.
ResetTransform()	Reimposta l'identità della proprietà Transform.
RotateTransform(Single)	Ruota la trasformazione geometrica locale in base alla quantità specificata. Questo metodo antepone la rotazione alla trasformazione.
RotateTransform(Single, MatrixOrder)	Ruota la trasformazione geometrica locale in base alla quantità specificata nell'ordine specificato.
ScaleTransform(Single, Single)	Ridimensiona la trasformazione geometrica locale in base agli importi specificati. Questo metodo antepone la matrice di ridimensionamento alla trasformazione.
ScaleTransform(Single, Single, MatrixOrder)	Ridimensiona la trasformazione geometrica locale in base agli importi specificati nell'ordine specificato.
SetBlendTriangularShape(Single)	Crea una sfumatura lineare con un colore centrale e un falloff lineare su un singolo colore su entrambe le estremità.
SetBlendTriangularShape(Single, Single)	Crea una sfumatura lineare con un colore centrale e un falloff lineare su un singolo 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 falloff sfumato basato su una curva a forma di campana.
SetSigmaBellShape(Single, Single)	Crea un falloff sfumato basato su una curva a forma di campana.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TranslateTransform(Single, Single)	Converte la trasformazione geometrica locale in base alle dimensioni specificate. Questo metodo antepone la traduzione alla trasformazione.
TranslateTransform(Single, Single, MatrixOrder)	Converte la trasformazione geometrica locale in base alle dimensioni specificate nell'ordine specificato.

Vedi anche

• Procedura: Creare una sfumatura lineare