Pen Klasse

Definition

Definiert ein Objekt, mit dem Linien und Kurven gezeichnet werden. Diese Klasse kann nicht vererbt werden.

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 eines Pen mit einem Brush und die Auswirkungen des Festlegens der LineJoin -Eigenschaft für ein Penveranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineJoin -Methode auf, wenn Sie das Ereignis des Formulars Paint behandeln, und übergeben Sie e als 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

Ein Pen zeichnet eine Linie der angegebenen Breite und des angegebenen Stils. Verwenden Sie die DashStyle -Eigenschaft, um mehrere Arten gestrichelter Linien zu zeichnen. Die von einem Pen gezeichnete Linie kann in einer Vielzahl von Füllstilen ausgefüllt werden, einschließlich Volltonfarben und Texturen. Der Füllstil hängt von Pinsel oder Textur ab, die als Füllobjekt verwendet wird.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

Pen(Brush)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Brush.

Pen(Brush, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen Width.

Pen(Color)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.

Pen(Color, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.

Eigenschaften

Alignment

Ruft die Ausrichtung für diesen Pen ab oder legt diese fest.

Brush

Ruft den Brush ab, der die Attribute dieses Pen bestimmt, oder legt dieses fest.

Color

Ruft die Farbe dieses Pen ab oder legt diese fest.

CompoundArray

Ruft ein Array von Werten ab, das einen Verbundstift angibt, oder legt dieses fest. Ein Verbundstift zeichnet eine Verbundlinie, die aus parallelen Linien und Zwischenräumen besteht.

CustomEndCap

Ruft ein benutzerdefiniertes Ende ab, das am Ende der mit diesem Pen gezeichneten Linien verwendet werden soll, oder legt dieses fest.

CustomStartCap

Ruft ein benutzerdefiniertes Ende ab, das am Anfang der mit diesem Pen gezeichneten Linien verwendet werden soll, oder legt dieses fest.

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.

DashOffset

Ruft den Abstand zwischen dem Anfang einer Zeile und dem Anfang eines Strichmusters ab oder legt diesen fest.

DashPattern

Ruft ein Array benutzerdefinierter Striche und Zwischenräume ab oder legt dieses fest.

DashStyle

Ruft den Stil der mit diesem Pen gezeichneten gestrichelten Linien ab oder legt diesen fest.

EndCap

Ruft den Stil für die Enden der mit diesem Pen gezeichneten Linien ab oder legt diesen fest.

LineJoin

Ruft die Verbindungsart für die Enden zweier aufeinander folgender Linien ab, die mit diesem Pen gezeichnet werden, oder legt diese fest.

MiterLimit

Ruft die Stärkenbegrenzung für die Verbindung in einer angeschrägten Ecke ab oder legt diese fest.

PenType

Ruft den Stil der mit diesem Pen gezeichneten Linien ab.

StartCap

Ruft den Stil für die Enden am Anfang der mit diesem Pen gezeichneten Linien ab oder legt diesen fest.

Transform

Ruft eine Kopie der geometrischen Transformation für diesen Pen ab oder legt diese fest.

Width

Ruft die Breite dieses Pen in Einheiten des zum Zeichnen verwendeten Graphics-Objekts ab oder legt diese fest.

Methoden

Clone()

Erstellt eine genaue Kopie von dieser Pen.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von dieser Pen verwendeten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
MultiplyTransform(Matrix)

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Multipliziert die Transformationsmatrix für diesen Pen mit der angegebenen Matrix in der angegebenen Reihenfolge.

ResetTransform()

Setzt die geometrische Transformationsmatrix für diesen Pen auf Identität zurück.

RotateTransform(Single)

Dreht die lokale geometrische Transformation um den angegebenen Winkel. Diese Methode stellt der Transformation die Drehung voran.

RotateTransform(Single, MatrixOrder)

Dreht die lokale geometrische Transformation um den angegebenen Winkel in der angegebenen Reihenfolge.

ScaleTransform(Single, Single)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren. Diese Methode stellt der Transformation die Skalierungsmatrix voran.

ScaleTransform(Single, Single, MatrixOrder)

Skaliert die lokale geometrische Transformation um die angegebenen Faktoren in der angegebenen Reihenfolge.

SetLineCap(LineCap, LineCap, DashCap)

Legt die Werte fest, die den Stil der Linienenden für mit diesem Pen gezeichnete Linien bestimmen.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TranslateTransform(Single, Single)

Verschiebt die lokale geometrische Transformation um die angegebenen Abmessungen. Diese Methode stellt der Transformation die Verschiebung voran.

TranslateTransform(Single, Single, MatrixOrder)

Verschiebt die lokale geometrische Transformation in der angegebenen Reihenfolge um die angegebenen Abmessungen.

Gilt für: