CustomLineCap Classe

Definizione

Incapsula un delimitatore di linea personalizzato definito dall'utente.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
Ereditarietà
CustomLineCap
Derivato
Implementazioni

Esempi

Nell'esempio riportato di seguito viene illustrato come utilizzare la classe CustomLineCap.The following example demonstrates how to use the CustomLineCap class. Per eseguire questo esempio, incollare il codice in un Windows Form.To run this example paste, the code into a Windows Form. Gestire Paint l'evento del form e chiamare DrawCaps dal metodo di gestione Paint degli eventi del form, passando e come 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

Commenti

I limiti di riga vengono utilizzati all'inizio e alla fine delle linee o delle curve disegnate da oggetti GDI+ Pen .Line caps are used at the beginnings and ends of lines or curves drawn by GDI+ Pen objects. GDI+ supporta diversi stili di estremità predefiniti e consente inoltre agli utenti di definire i propri stili di estremità.GDI+ supports several predefined cap styles, and also allows users to define their own cap styles. Questa classe viene utilizzata per creare stili di estremità personalizzati.This class is used to create custom cap styles.

Costruttori

CustomLineCap(GraphicsPath, GraphicsPath)

Inizializza una nuova istanza della classe CustomLineCap con il contorno e il riempimento specificati.Initializes a new instance of the CustomLineCap class with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap)

Inizializza una nuova istanza della classe CustomLineCap dall'enumerazione LineCap esistente specificata con il contorno e il riempimento indicati.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)

Inizializza una nuova istanza della classe CustomLineCap dall'enumerazione LineCap esistente specificata con il contorno, riempimento e interno indicati.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline, fill, and inset.

Proprietà

BaseCap

Ottiene o imposta l'enumerazione LineCap sulla quale si basa questo CustomLineCap.Gets or sets the LineCap enumeration on which this CustomLineCap is based.

BaseInset

Ottiene o imposta la distanza tra il delimitatore e la linea.Gets or sets the distance between the cap and the line.

StrokeJoin

Ottiene o imposta l'enumerazione LineJoin che determina la modalità di unione delle linee che compongono questo oggetto CustomLineCap.Gets or sets the LineJoin enumeration that determines how lines that compose this CustomLineCap object are joined.

WidthScale

Ottiene o imposta il valore in base al quale modificare le proporzioni di questo oggetto della classe CustomLineCap rispetto alla larghezza dell'oggetto Pen.Gets or sets the amount by which to scale this CustomLineCap Class object with respect to the width of the Pen object.

Metodi

Clone()

Crea una copia esatta di questo CustomLineCap.Creates an exact copy of this CustomLineCap.

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate dall'oggetto CustomLineCap.Releases all resources used by this CustomLineCap object.

Dispose(Boolean)

Rilascia le risorse non gestite usate da CustomLineCap e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the CustomLineCap and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Finalize()

Consente a un oggetto CustomLineCap di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto CustomLineCap stesso venga recuperato dalla procedura di Garbage Collection.Allows an CustomLineCap to attempt to free resources and perform other cleanup operations before the CustomLineCap is reclaimed by garbage collection.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)

Ottiene i delimitatori utilizzati per iniziare e terminare le linee che compongono questo delimitatore personalizzato.Gets the caps used to start and end lines that make up this custom cap.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)

Imposta i delimitatori utilizzati per iniziare e terminare le linee che compongono questo delimitatore personalizzato.Sets the caps used to start and end lines that make up this custom cap.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a