CustomLineCap CustomLineCap CustomLineCap CustomLineCap Class

Definition

Kapselt ein benutzerdefiniertes Linienende ein.Encapsulates a custom user-defined line cap.

public ref class CustomLineCap : MarshalByRefObject, ICloneable, IDisposable
public class CustomLineCap : MarshalByRefObject, ICloneable, IDisposable
type CustomLineCap = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
Public Class CustomLineCap
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
Vererbung
Abgeleitet
Implementiert

Beispiele

Im folgenden Beispiel wird die Verwendung der CustomLineCap-Klasse veranschaulicht.The following example demonstrates how to use the CustomLineCap class. In diesem Beispiel fügen Sie den Code in eine Windows Form ausgeführt.To run this example paste, the code into a Windows Form. Behandeln Sie das Paint Ereignis, und rufen DrawCaps aus des Formulars Paint Ereignisbehandlungsmethode, übergeben e als PaintEventArgs.Handle the form's Paint event and call DrawCaps from the form's Paint event-handling method, passing e as PaintEventArgs.


protected void DrawCaps(PaintEventArgs e)
{
    GraphicsPath hPath = new GraphicsPath();

    // Create the outline for our custom end cap.
    hPath.AddLine(new Point(0, 0), new Point(0, 5));
    hPath.AddLine(new Point(0, 5), new Point(5, 1));
    hPath.AddLine(new Point(5, 1), new Point(3, 1));

    // Construct the hook-shaped end cap.
    CustomLineCap HookCap = new CustomLineCap(null, hPath);

    // Set the start cap and end cap of the HookCap to be rounded.
    HookCap.SetStrokeCaps(LineCap.Round, LineCap.Round);

    // Create a pen and set end custom start and end
    // caps to the hook cap.
    Pen customCapPen = new Pen(Color.Black, 5);
    customCapPen.CustomStartCap = HookCap;
    customCapPen.CustomEndCap = HookCap;

    // Create a second pen using the start and end caps from
    // the hook cap.
    Pen capPen = new Pen(Color.Red, 10);
    LineCap startCap;
    LineCap endCap;
    HookCap.GetStrokeCaps(out startCap, out endCap);
    capPen.StartCap = startCap;
    capPen.EndCap = endCap;

    // Create a line to draw.
    Point[] points = { new Point(100, 100), new Point(200, 50), 
        new Point(250, 300) };

    // Draw the lines.
    e.Graphics.DrawLines(capPen, points);
    e.Graphics.DrawLines(customCapPen, points);

}
Protected Sub DrawCaps(ByVal e As PaintEventArgs)
    Dim hPath As New GraphicsPath()

    ' Create the outline for our custom end cap.
    hPath.AddLine(New Point(0, 0), New Point(0, 5))
    hPath.AddLine(New Point(0, 5), New Point(5, 1))
    hPath.AddLine(New Point(5, 1), New Point(3, 1))

    ' Construct the hook-shaped end cap.
    Dim HookCap As New CustomLineCap(Nothing, hPath)

    ' Set the start cap and end cap of the HookCap to be rounded.
    HookCap.SetStrokeCaps(LineCap.Round, LineCap.Round)

    ' Create a pen and set end custom start and end
    ' caps to the hook cap.
    Dim customCapPen As New Pen(Color.Black, 5)
    customCapPen.CustomStartCap = HookCap
    customCapPen.CustomEndCap = HookCap

    ' Create a second pen using the start and end caps from
    ' the hook cap.
    Dim capPen As New Pen(Color.Red, 10)
    Dim startCap As LineCap
    Dim endCap As LineCap
    HookCap.GetStrokeCaps(startCap, endCap)
    capPen.StartCap = startCap
    capPen.EndCap = endCap

    ' Create a line to draw.
    Dim points As Point() = {New Point(100, 100), New Point(200, 50), _
        New Point(250, 300)}

    ' Draw the lines.
    e.Graphics.DrawLines(capPen, points)
    e.Graphics.DrawLines(customCapPen, points)

End Sub

Hinweise

Linienenden wird am Anfang und Ende von Linien und Kurven, die von GDI + gezeichnet Pen Objekte.Line caps are used at the beginnings and ends of lines or curves drawn by GDI+ Pen objects. GDI + unterstützt mehrere vordefinierte Endenformate und außerdem können Benutzer ihre eigenen Endenformate zu definieren.GDI+ supports several predefined cap styles, and also allows users to define their own cap styles. Diese Klasse dient zum Erstellen von benutzerdefinierten Endes Stilen.This class is used to create custom cap styles.

Konstruktoren

CustomLineCap(GraphicsPath, GraphicsPath) CustomLineCap(GraphicsPath, GraphicsPath) CustomLineCap(GraphicsPath, GraphicsPath) CustomLineCap(GraphicsPath, GraphicsPath)

Initialisiert eine neue Instanz der CustomLineCap-Klasse mit dem angegebenen Umriss und der angegebenen Füllung.Initializes a new instance of the CustomLineCap class with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap)

Initialisiert aus der angegebenen vorhandenen CustomLineCap-Enumeration eine neue Instanz der LineCap-Klasse mit dem angegebenen Umriss und der angegebenen Füllung.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)

Initialisiert aus der angegebenen vorhandenen CustomLineCap-Enumeration eine neue Instanz der LineCap-Klasse mit dem angegebenen Umriss, der angegebenen Füllung und der angegebenen Absenkung.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline, fill, and inset.

Eigenschaften

BaseCap BaseCap BaseCap BaseCap

Ruft die LineCap-Enumeration ab, auf der dieses CustomLineCap basiert, oder legt diese fest.Gets or sets the LineCap enumeration on which this CustomLineCap is based.

BaseInset BaseInset BaseInset BaseInset

Ruft den Abstand zwischen dem Ende und der Linie ab oder legt diesen fest.Gets or sets the distance between the cap and the line.

StrokeJoin StrokeJoin StrokeJoin StrokeJoin

Ruft die LineJoin-Enumeration ab, die bestimmt, wie die Linien miteinander verbunden werden, aus denen dieses CustomLineCap-Objekt besteht.Gets or sets the LineJoin enumeration that determines how lines that compose this CustomLineCap object are joined.

WidthScale WidthScale WidthScale WidthScale

Ruft den Betrag ab, um den dieses Objekt der CustomLineCap-Klasse in Bezug auf die Breite des Pen-Objekts skaliert wird, oder legt diesen fest.Gets or sets the amount by which to scale this CustomLineCap Class object with respect to the width of the Pen object.

Methoden

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

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

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 diesem CustomLineCap-Objekt verwendeten Ressourcen frei.Releases all resources used by this CustomLineCap object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von CustomLineCap verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the CustomLineCap and optionally releases the managed resources.

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 CustomLineCap Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor das CustomLineCap von der Garbage Collection freigegeben wird.Allows an CustomLineCap to attempt to free resources and perform other cleanup operations before the CustomLineCap 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)
GetStrokeCaps(LineCap, LineCap) GetStrokeCaps(LineCap, LineCap) GetStrokeCaps(LineCap, LineCap) GetStrokeCaps(LineCap, LineCap)

Ruft die Enden für Linienanfang und -ende dieses benutzerdefinierten Endes ab.Gets the caps used to start and end lines that make up this custom cap.

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)
SetStrokeCaps(LineCap, LineCap) SetStrokeCaps(LineCap, LineCap) SetStrokeCaps(LineCap, LineCap) SetStrokeCaps(LineCap, LineCap)

Legt die Enden für Linienanfang und -ende dieses benutzerdefinierten Endes fest.Sets the caps used to start and end lines that make up this custom cap.

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)

Gilt für: