Pen Classe

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Pen.cs

Definisce un oggetto usato per disegnare linee e curve. La classe non può essere ereditata.

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable

public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable

type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable

Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable

Ereditarietà

Object

MarshalByRefObject

Pen

Implementazioni

ICloneable IDisposable

Esempio

L'esempio di codice seguente illustra la costruzione di un Pen oggetto con e Brush gli effetti dell'impostazione della LineJoin proprietà su un Penoggetto .

Questo esempio è progettato per essere usato con Windows Forms. Incollare il codice in un modulo e chiamare il ShowLineJoin metodo durante la gestione dell'evento del Paint modulo, passando e come PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Commenti

Un Pen oggetto disegna una linea di larghezza e stile specificati. Utilizzare la DashStyle proprietà per disegnare diverse varietà di linee tratteggiate. La linea disegnata da un Pen può essere riempita in diversi stili di riempimento, tra cui colori a tinta unita e trame. Lo stile di riempimento dipende dal pennello o dalla trama usata come oggetto riempimento.

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 e eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Costruttori

Pen(Brush)	Inizializza una nuova istanza della classe Pen con l'oggetto Brush specificato.
Pen(Brush, Single)	Inizializza una nuova istanza della classe Pen con gli oggetti Brush e Width specificati.
Pen(Color)	Inizializza una nuova istanza della classe Pen con il colore specificato.
Pen(Color, Single)	Inizializza una nuova istanza della classe Pen con le proprietà Color e Width specificate.

Proprietà

Alignment	Ottiene o imposta l'allineamento per questa classe Pen.
Brush	Ottiene o imposta la classe Brush che determina gli attributi di questa classe Pen.
Color	Ottiene o imposta il colore di questa classe Pen.
CompoundArray	Ottiene o imposta una matrice di valori che specifica una penna composta. Una penna composta disegna una linea composta costituita da linee parallele e spazi.
CustomEndCap	Ottiene o imposta una terminazione personalizzata da usare alla fine delle linee disegnate con questo oggetto Pen.
CustomStartCap	Ottiene o imposta una terminazione personalizzata da usare all'inizio delle linee disegnate con questo oggetto Pen.
DashCap	Ottiene o imposta il tipo di terminazione usato alla fine dei trattini che costituiscono le linee tratteggiate disegnate con questo oggetto Pen.
DashOffset	Ottiene o imposta la distanza dall'inizio di una linea all'inizio di un motivo a tratteggio.
DashPattern	Ottiene o imposta una matrice di trattini e spazi personalizzati.
DashStyle	Ottiene o imposta lo stile usato per le linee tratteggiate disegnate con questo oggetto Pen.
EndCap	Ottiene o imposta il tipo di terminazione usato alla fine delle linee disegnate con questo oggetto Pen.
LineJoin	Ottiene o imposta il tipo di join delle terminazioni di due linee consecutive disegnate con questo oggetto Pen.
MiterLimit	Ottiene o imposta il limite dello spessore del join su un angolo retto.
PenType	Ottiene lo stile delle linee disegnate con questo oggetto Pen.
StartCap	Ottiene o imposta il tipo di terminazione usato all'inizio delle linee disegnate con questo oggetto Pen.
Transform	Ottiene o imposta una copia della trasformazione geometrica per l'oggetto Pen.
Width	Ottiene o imposta la larghezza di Pen, in unità dell'oggetto Graphics usato per disegnare.

Metodi

Clone()	Crea una copia esatta di questo Pen.
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 da questa classe Pen.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Finalize()	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.
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 matrice di trasformazione di questo oggetto Pen per la classe Matrix specificata.
MultiplyTransform(Matrix, MatrixOrder)	Moltiplica la matrice di trasformazione di questo oggetto Pen per la classe Matrix specificata nell'ordine indicato.
ResetTransform()	Reimposta la matrice di trasformazione geometrica per questo oggetto Pen sull'identità.
RotateTransform(Single)	Ruota la trasformazione geometrica locale in base all'angolo specificato. Questo metodo antepone la rotazione alla trasformazione.
RotateTransform(Single, MatrixOrder)	Ruota la trasformazione geometrica locale in base all'angolo specificato nell'ordine indicato.
ScaleTransform(Single, Single)	Scala la trasformazione geometrica locale in base ai fattori specificati. Il metodo antepone la matrice di scala alla trasformazione.
ScaleTransform(Single, Single, MatrixOrder)	Scala la trasformazione geometrica locale in base ai fattori specificati nell'ordine indicato.
SetLineCap(LineCap, LineCap, DashCap)	Imposta i valori che determinano il tipo di terminazione usato alla fine delle linee disegnate da questo oggetto Pen.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TranslateTransform(Single, Single)	Trasla la trasformazione geometrica locale in base alle dimensioni specificate. Questo metodo antepone la traslazione alla trasformazione.
TranslateTransform(Single, Single, MatrixOrder)	Trasla la trasformazione geometrica locale in base alle dimensioni specificate nell'ordine indicato.