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, mit dem Linien und Kurven gezeichnet werden. 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
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. |
