Pen Pen Pen Pen Class

Definition

Definiert ein Objekt, mit dem Linien und Kurven gezeichnet werden.Defines an object used to draw lines and curves. Diese Klasse kann nicht vererbt werden.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
Vererbung
Implementiert

Beispiele

Im folgenden Codebeispiel wird das Erstellen Pen eines mit Brush einem und die Auswirkungen der fest LineJoin legung der- PenEigenschaft auf ein veranschaulicht.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Fügen Sie den Code in ein Formular ein, ShowLineJoin und nennen Sie die-Methode Paint , wenn Sie das PaintEventArgs-Ereignis des Formulars verarbeiten und als übergeben e .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

Hinweise

Eine Pen zeichnet eine Linie mit der angegebenen Breite und dem angegebenen Stil.A Pen draws a line of specified width and style. Verwenden Sie DashStyle die-Eigenschaft, um mehrere Arten von gestrichelte Linien zu zeichnen.Use the DashStyle property to draw several varieties of dashed lines. Die von einem Pen gezeichnete Linie kann in verschiedene Füll Stile eingefügt werden, einschließlich voll Tonfarben und Texturen.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. Der Füllstil hängt von dem Pinsel oder der Textur ab, der als Füll Objekt verwendet wird.The fill style depends on brush or texture that is used as the fill object.

Konstruktoren

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

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Brush.Initializes a new instance of the Pen class with the specified Brush.

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

Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen Width.Initializes a new instance of the Pen class with the specified Brush and Width.

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

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.Initializes a new instance of the Pen class with the specified color.

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

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.Initializes a new instance of the Pen class with the specified Color and Width properties.

Eigenschaften

Alignment Alignment Alignment Alignment

Ruft die Ausrichtung für diesen Pen ab oder legt diese fest.Gets or sets the alignment for this Pen.

Brush Brush Brush Brush

Ruft den Brush ab, der die Attribute dieses Pen bestimmt, oder legt dieses fest.Gets or sets the Brush that determines attributes of this Pen.

Color Color Color Color

Ruft die Farbe dieses Pen ab oder legt diese fest.Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray CompoundArray

Ruft ein Array von Werten ab, das einen Verbundstift angibt, oder legt dieses fest.Gets or sets an array of values that specifies a compound pen. Ein Verbundstift zeichnet eine Verbundlinie, die aus parallelen Linien und Zwischenräumen besteht.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap CustomEndCap CustomEndCap CustomEndCap

Ruft ein benutzerdefiniertes Ende ab, das am Ende der mit diesem Pen gezeichneten Linien verwendet werden soll, oder legt dieses fest.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

Ruft ein benutzerdefiniertes Ende ab, das am Anfang der mit diesem Pen gezeichneten Linien verwendet werden soll, oder legt dieses fest.Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap DashCap DashCap DashCap

Ruft den Stil für die Enden ab, der für die Enden der gestrichelten Linien verwendet wird, die mit diesem Pen gezeichnet werden, oder legt diesen fest.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

Ruft den Abstand zwischen dem Anfang einer Zeile und dem Anfang eines Strichmusters ab oder legt diesen fest.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern DashPattern DashPattern DashPattern

Ruft ein Array benutzerdefinierter Striche und Zwischenräume ab oder legt dieses fest.Gets or sets an array of custom dashes and spaces.

DashStyle DashStyle DashStyle DashStyle

Ruft den Stil der mit diesem Pen gezeichneten gestrichelten Linien ab oder legt diesen fest.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap EndCap EndCap EndCap

Ruft den Stil für die Enden der mit diesem Pen gezeichneten Linien ab oder legt diesen fest.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin LineJoin LineJoin LineJoin

Ruft die Verbindungsart für die Enden zweier aufeinander folgender Linien ab, die mit diesem Pen gezeichnet werden, oder legt diese fest.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit MiterLimit MiterLimit MiterLimit

Ruft die Stärkenbegrenzung für die Verbindung in einer angeschrägten Ecke ab oder legt diese fest.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType PenType PenType PenType

Ruft den Stil der mit diesem Pen gezeichneten Linien ab.Gets the style of lines drawn with this Pen.

StartCap StartCap StartCap StartCap

Ruft den Stil für die Enden am Anfang der mit diesem Pen gezeichneten Linien ab oder legt diesen fest.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform Transform Transform Transform

Ruft eine Kopie der geometrischen Transformation für diesen Pen ab oder legt diese fest.Gets or sets a copy of the geometric transformation for this Pen.

Width Width Width Width

Ruft die Breite dieses Pen in Einheiten des zum Zeichnen verwendeten Graphics-Objekts ab oder legt diese fest.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Methoden

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

Erstellt eine genaue Kopie von dieser Pen.Creates an exact copy of this Pen.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.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()

Gibt alle von dieser Pen verwendeten Ressourcen frei.Releases all resources used by this Pen.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

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

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix.Multiplies the transformation matrix for this Pen by the specified Matrix.

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

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix in der angegebenen Reihenfolge.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

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

Setzt die geometrische Transformationsmatrix für diesen Pen auf Identität zurück.Resets the geometric transformation matrix for this Pen to identity.

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

Dreht die lokale geometrische Transformation um den angegebenen Winkel.Rotates the local geometric transformation by the specified angle. Diese Methode stellt der Transformation die Drehung voran.This method prepends the rotation to the transformation.

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

Dreht die lokale geometrische Transformation um den angegebenen Winkel in der angegebenen Reihenfolge.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)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren.Scales the local geometric transformation by the specified factors. Diese Methode stellt der Transformation die Skalierungsmatrix voran.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)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren in der angegebenen Reihenfolge.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)

Legt die Werte fest, die den Stil der Linienenden für mit diesem Pen gezeichnete Linien bestimmen.Sets the values that determine the style of cap used to end lines drawn by this Pen.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

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

Verschiebt die lokale geometrische Transformation um die angegebenen Abmessungen.Translates the local geometric transformation by the specified dimensions. Diese Methode stellt der Transformation die Verschiebung voran.This method prepends the translation to the transformation.

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

Verschiebt die lokale geometrische Transformation in der angegebenen Reihenfolge um die angegebenen Abmessungen.Translates the local geometric transformation by the specified dimensions in the specified order.

Gilt für: