Pen Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert ein Objekt, das zum Zeichnen von Linien und Kurven verwendet wird. Diese Klasse kann nicht vererbt werden.
public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposablepublic sealed class Pen : MarshalByRefObject, ICloneable, IDisposabletype Pen = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposablePublic NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable- Vererbung
- Implementiert
Beispiele
Das folgende Codebeispiel veranschaulicht das Erstellen einer Pen mit einer Brush und der Auswirkungen der Festlegung der LineJoin Eigenschaft auf ein Pen.
Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineJoin Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.
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
A Pen zeichnet eine Linie mit angegebener Breite und Formatvorlage. Verwenden Sie die DashStyle Eigenschaft, um mehrere Arten gestrichelter Linien zu zeichnen. Die linie, die von einer Pen Füllung gezeichnet wird, kann in einer Vielzahl von Füllformaten gefüllt werden, einschließlich Volltonfarben und Texturen. Die Füllformatvorlage 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 führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Pen(Brush, Single) |
Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Brush und Width. |
| Pen(Brush) |
Initialisiert eine neue Instanz der Pen Klasse mit dem angegebenen Brush. |
| Pen(Color, Single) |
Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Color Und Width Eigenschaften. |
| Pen(Color) |
Initialisiert eine neue Instanz der Pen Klasse mit der angegebenen Farbe. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Alignment |
Dient zum Abrufen oder Festlegen der Ausrichtung für dieses Pen. |
| Brush |
Dient zum Abrufen oder Festlegen der Brush Attribute dieses PenWerts. |
| Color |
Dient zum Abrufen oder Festlegen der Farbe dieses Werts Pen. |
| CompoundArray |
Dient zum Abrufen oder Festlegen eines Arrays von Werten, das einen zusammengesetzten Stift angibt. Ein zusammengesetzter Stift zeichnet eine zusammengesetzte Linie aus parallelen Linien und Leerzeichen. |
| CustomEndCap |
Dient zum Abrufen oder Festlegen einer benutzerdefinierten Kappe, die am Ende der mit diesem PenLinien gezeichneten Linien verwendet werden soll. |
| CustomStartCap |
Dient zum Abrufen oder Festlegen einer benutzerdefinierten Kappe, die am Anfang von Linien verwendet werden soll, die mit diesem Pengezeichnet werden. |
| DashCap |
Dient zum Abrufen oder Festlegen der Kappenart, die am Ende der Striche verwendet wird, die gestrichelte Linien bilden, die mit diesem Pengezeichnet werden. |
| DashOffset |
Dient zum Abrufen oder Festlegen des Abstands vom Anfang einer Linie zum Anfang eines Strichmusters. |
| DashPattern |
Dient zum Abrufen oder Festlegen eines Arrays von benutzerdefinierten Strichen und Leerzeichen. |
| DashStyle |
Dient zum Abrufen oder Festlegen der Formatvorlage, die für gestrichelte Linien verwendet wird, die mit diesem Pengezeichnet werden. |
| EndCap |
Dient zum Abrufen oder Festlegen der Kappenformatvorlage, die am Ende von Linien verwendet wird, die mit diesem Pengezeichnet werden. |
| LineJoin |
Dient zum Abrufen oder Festlegen der Verknüpfungsart für die Enden von zwei aufeinander folgenden Linien, die mit diesem Pengezeichnet werden. |
| MiterLimit |
Ruft die Grenze der Stärke der Verknüpfung auf einer gemilbeten Ecke ab oder legt diese fest. |
| PenType |
Ruft die Formatvorlage von Linien ab, die mit diesem Pengezeichnet werden. |
| StartCap |
Dient zum Abrufen oder Festlegen der Kappenformatvorlage, die am Anfang von Linien verwendet wird, die mit diesem Pengezeichnet werden. |
| Transform |
Dient zum Abrufen oder Festlegen einer Kopie der geometrischen Transformation für diese Pen. |
| Width |
Ruft die Breite dieses PenObjekts in Einheiten ab, die für die Graphics Zeichnung verwendet werden, oder legt diese fest. |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt eine genaue Kopie dieses PenElements. |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| Dispose() |
Gibt alle von diesem PenRessourcen verwendeten Ressourcen frei. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| Finalize() |
Ermöglicht es einem Objekt, Ressourcen freizugeben und andere Bereinigungsvorgänge auszuführen, bevor es von der Garbage Collection erneut beansprucht wird. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| MultiplyTransform(Matrix, MatrixOrder) |
Multipliziert die Transformationsmatrix dafür Pen mit der in der angegebenen Reihenfolge angegebenen Matrix Reihenfolge. |
| MultiplyTransform(Matrix) |
Multipliziert die Transformationsmatrix dafür Pen durch die angegebene Matrix. |
| ResetTransform() |
Setzt die geometrische Transformationsmatrix für diese Pen auf Identität zurück. |
| RotateTransform(Single, MatrixOrder) |
Dreht die lokale geometrische Transformation um den angegebenen Winkel in der angegebenen Reihenfolge. |
| RotateTransform(Single) |
Dreht die lokale geometrische Transformation um den angegebenen Winkel. Diese Methode stellt die Drehung der Transformation voran. |
| ScaleTransform(Single, Single, MatrixOrder) |
Skaliert die lokale geometrische Transformation durch die angegebenen Faktoren in der angegebenen Reihenfolge. |
| ScaleTransform(Single, Single) |
Skaliert die lokale geometrische Transformation durch die angegebenen Faktoren. Diese Methode stellt die Skalierungsmatrix der Transformation voran. |
| SetLineCap(LineCap, LineCap, DashCap) |
Legt die Werte fest, die das Format der Kapitälchen bestimmen, die für endende Linien verwendet werden, die von diesem Pengezeichnet werden. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TranslateTransform(Single, Single, MatrixOrder) |
Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen in der angegebenen Reihenfolge. |
| TranslateTransform(Single, Single) |
Übersetzt die lokale geometrische Transformation durch die angegebenen Dimensionen. Diese Methode stellt die Übersetzung der Transformation voran. |
