Condividi tramite

Pen Classe

Definizione

Spazio dei nomi:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Pacchetto:
System.Drawing.Common v11.0.0-preview.2.26159.112
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs
Origine:
Pen.cs

Definisce un oggetto utilizzato per disegnare linee e curve. Questa 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

Nell'esempio di codice seguente viene illustrata la creazione di un Pen oggetto con e Brush gli effetti dell'impostazione della LineJoin proprietà su un oggetto Pen.

Questo esempio è progettato per essere usato con Windows Form. Incollare il codice in una maschera e chiamare il ShowLineJoin metodo quando si gestisce l'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 oggetto può essere riempita in una varietà di stili di riempimento, inclusi colori a tinta unita e trame. Lo stile di riempimento dipende dal pennello o dalla trama utilizzata come oggetto di riempimento.

Annotazioni

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

Nome Descrizione
Pen(Brush, Single)

Inizializza una nuova istanza della Pen classe con l'oggetto e WidthspecificatoBrush.
Pen(Brush)

Inizializza una nuova istanza della Pen classe con l'oggetto specificato Brush.
Pen(Color, Single)

Inizializza una nuova istanza della Pen classe con le proprietà e Width specificateColor.
Pen(Color)

Inizializza una nuova istanza della Pen classe con il colore specificato.

Proprietà

Nome Descrizione
Alignment

Ottiene o imposta l'allineamento per l'oggetto Pen.
Brush

Ottiene o imposta l'oggetto Brush che determina gli attributi di questo Penoggetto .
Color

Ottiene o imposta il colore dell'oggetto Pen.
CompoundArray

Ottiene o imposta una matrice di valori che specifica una penna composta. Una penna composta disegna una linea composta costituita da linee e spazi paralleli.
CustomEndCap

Ottiene o imposta un limite personalizzato da utilizzare alla fine delle linee disegnate con questo Penoggetto .
CustomStartCap

Ottiene o imposta un limite personalizzato da utilizzare all'inizio delle linee disegnate con questo Penoggetto .
DashCap

Ottiene o imposta lo stile dell'estremità utilizzato alla fine dei trattini che costituiscono linee tratteggiate disegnate con questo Penoggetto .
DashOffset

Ottiene o imposta la distanza dall'inizio di una linea all'inizio di un motivo tratteggiato.
DashPattern

Ottiene o imposta una matrice di trattini e spazi personalizzati.
DashStyle

Ottiene o imposta lo stile utilizzato per le linee tratteggiate disegnate con questo Penoggetto .
EndCap

Ottiene o imposta lo stile dell'estremità utilizzato alla fine delle linee disegnate con questo Penoggetto .
LineJoin

Ottiene o imposta lo stile di join per le estremità di due linee consecutive disegnate con questo Penoggetto .
MiterLimit

Ottiene o imposta il limite dello spessore del join su un angolo con mitering.
PenType

Ottiene lo stile delle linee disegnate con questo Penoggetto .
StartCap

Ottiene o imposta lo stile dell'estremità utilizzato all'inizio delle linee disegnate con questo Penoggetto .
Transform

Ottiene o imposta una copia della trasformazione geometrica per questo Penoggetto .
Width

Ottiene o imposta la larghezza di questo Penoggetto , in unità dell'oggetto utilizzato per il Graphics disegno.

Metodi

Nome Descrizione
Clone()

Crea una copia esatta di questo Penoggetto .
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 Penoggetto .
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Finalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperata da Garbage Collection.
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 corrente MarshalByRefObject .

(Ereditato da MarshalByRefObject)
MultiplyTransform(Matrix, MatrixOrder)

Moltiplica la matrice di trasformazione per questo Pen oggetto in base all'oggetto specificato Matrix nell'ordine specificato.
MultiplyTransform(Matrix)

Moltiplica la matrice di trasformazione per questo Pen oggetto in base all'oggetto specificato Matrix.
ResetTransform()

Reimposta la matrice di trasformazione geometrica per questa Pen identità.
RotateTransform(Single, MatrixOrder)

Ruota la trasformazione geometrica locale in base all'angolo specificato nell'ordine specificato.
RotateTransform(Single)

Ruota la trasformazione geometrica locale in base all'angolo specificato. Questo metodo antepone la rotazione alla trasformazione.
ScaleTransform(Single, Single, MatrixOrder)

Ridimensiona la trasformazione geometrica locale in base ai fattori specificati nell'ordine specificato.
ScaleTransform(Single, Single)

Ridimensiona la trasformazione geometrica locale in base ai fattori specificati. Questo metodo antepone la matrice di ridimensionamento alla trasformazione.
SetLineCap(LineCap, LineCap, DashCap)

Imposta i valori che determinano lo stile dell'estremità utilizzata per terminare le linee disegnate da questo Penoggetto .
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TranslateTransform(Single, Single, MatrixOrder)

Converte la trasformazione geometrica locale in base alle dimensioni specificate nell'ordine specificato.
TranslateTransform(Single, Single)

Converte la trasformazione geometrica locale in base alle dimensioni specificate. Questo metodo antepone la traduzione alla trasformazione.

Si applica a