Pen Pen Pen Pen Class

Definizione

Definisce un oggetto usato per disegnare linee e curve.Defines an object used to draw lines and curves. Questa classe non può essere ereditata.This class cannot be inherited.

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à
Implementazioni

Esempi

Il codice seguente viene illustrata la costruzione di un Pen con un Brush e gli effetti dell'impostazione di LineJoin proprietà su un Pen.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

In questo esempio è progettato per essere usato con Windows Form.This example is designed to be used with Windows Forms. Incollare il codice in un form e si chiama il ShowLineJoin metodo durante la gestione del modulo Paint evento passando e come PaintEventArgs.Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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

Oggetto Pen Disegna una linea di spessore specificato e lo stile.A Pen draws a line of specified width and style. Usare il DashStyle proprietà per creare diversi tipi di linee tratteggiate.Use the DashStyle property to draw several varieties of dashed lines. La riga disegnata da un Pen può essere riempita con diversi stili di riempimento, inclusi colori a tinta unita e trame.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. Lo stile di riempimento dipende dal pennello o dalla trama utilizzata come oggetto di riempimento.The fill style depends on brush or texture that is used as the fill object.

Costruttori

Pen(Brush) Pen(Brush) Pen(Brush) Pen(Brush)

Inizializza una nuova istanza della classe Pen con l'oggetto Brush specificato.Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single)

Inizializza una nuova istanza della classe Pen con gli oggetti Brush e Width specificati.Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color) Pen(Color) Pen(Color) Pen(Color)

Inizializza una nuova istanza della classe Pen con il colore specificato.Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single) Pen(Color, Single) Pen(Color, Single) Pen(Color, Single)

Inizializza una nuova istanza della classe Pen con le proprietà Color e Width specificate.Initializes a new instance of the Pen class with the specified Color and Width properties.

Proprietà

Alignment Alignment Alignment Alignment

Ottiene o imposta l'allineamento per questa classe Pen.Gets or sets the alignment for this Pen.

Brush Brush Brush Brush

Ottiene o imposta la classe Brush che determina gli attributi di questa classe Pen.Gets or sets the Brush that determines attributes of this Pen.

Color Color Color Color

Ottiene o imposta il colore di questa classe Pen.Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray CompoundArray

Ottiene o imposta una matrice di valori che specifica una penna composta.Gets or sets an array of values that specifies a compound pen. Una penna composta disegna una linea composta costituita da linee parallele e spazi.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap CustomEndCap CustomEndCap CustomEndCap

Ottiene o imposta una terminazione personalizzata da usare alla fine delle linee disegnate con questo oggetto Pen.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

Ottiene o imposta una terminazione personalizzata da usare all'inizio delle linee disegnate con questo oggetto Pen.Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap DashCap DashCap DashCap

Ottiene o imposta il tipo di terminazione usato alla fine dei trattini che costituiscono le linee tratteggiate disegnate con questo oggetto Pen.Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset DashOffset DashOffset DashOffset

Ottiene o imposta la distanza dall'inizio di una linea all'inizio di un motivo a tratteggio.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern DashPattern DashPattern DashPattern

Ottiene o imposta una matrice di trattini e spazi personalizzati.Gets or sets an array of custom dashes and spaces.

DashStyle DashStyle DashStyle DashStyle

Ottiene o imposta lo stile usato per le linee tratteggiate disegnate con questo oggetto Pen.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap EndCap EndCap EndCap

Ottiene o imposta il tipo di terminazione usato alla fine delle linee disegnate con questo oggetto Pen.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin LineJoin LineJoin LineJoin

Ottiene o imposta il tipo di join delle terminazioni di due linee consecutive disegnate con questo oggetto Pen.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit MiterLimit MiterLimit MiterLimit

Ottiene o imposta il limite dello spessore del join su un angolo retto.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType PenType PenType PenType

Ottiene lo stile delle linee disegnate con questo oggetto Pen.Gets the style of lines drawn with this Pen.

StartCap StartCap StartCap StartCap

Ottiene o imposta il tipo di terminazione usato all'inizio delle linee disegnate con questo oggetto Pen.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform Transform Transform Transform

Ottiene o imposta una copia della trasformazione geometrica per l'oggetto Pen.Gets or sets a copy of the geometric transformation for this Pen.

Width Width Width Width

Ottiene o imposta la larghezza di Pen, in unità dell'oggetto Graphics usato per disegnare.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Metodi

Clone() Clone() Clone() Clone()

Crea una copia esatta di questo Pen.Creates an exact copy of this Pen.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da questa classe Pen.Releases all resources used by this Pen.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() 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.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

Moltiplica la matrice di trasformazione di questo oggetto Pen per la classe Matrix specificata.Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

Moltiplica la matrice di trasformazione di questo oggetto Pen per la classe Matrix specificata nell'ordine indicato.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

Reimposta la matrice di trasformazione geometrica per questo oggetto Pen sull'identità.Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

Ruota la trasformazione geometrica locale in base all'angolo specificato.Rotates the local geometric transformation by the specified angle. Questo metodo antepone la rotazione alla trasformazione.This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

Ruota la trasformazione geometrica locale in base all'angolo specificato nell'ordine indicato.Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single)

Scala la trasformazione geometrica locale in base ai fattori specificati.Scales the local geometric transformation by the specified factors. Il metodo antepone la matrice di scala alla trasformazione.This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

Scala la trasformazione geometrica locale in base ai fattori specificati nell'ordine indicato.Scales the local geometric transformation by the specified factors in the specified order.

SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap)

Imposta i valori che determinano il tipo di terminazione usato alla fine delle linee disegnate da questo oggetto Pen.Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

Trasla la trasformazione geometrica locale in base alle dimensioni specificate.Translates the local geometric transformation by the specified dimensions. Questo metodo antepone la traslazione alla trasformazione.This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

Trasla la trasformazione geometrica locale in base alle dimensioni specificate nell'ordine indicato.Translates the local geometric transformation by the specified dimensions in the specified order.

Si applica a