CustomLineCap Classe

Définition

Encapsule un embout de ligne personnalisé défini par l'utilisateur.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
Héritage
CustomLineCap
Dérivé
Implémente

Exemples

L'exemple suivant montre comment utiliser la classe CustomLineCap.The following example demonstrates how to use the CustomLineCap class. Pour exécuter cet exemple, collez le code dans un Windows Form.To run this example paste, the code into a Windows Form. Gérez l’événement Paint du formulaire et appelez DrawCaps à partir de la méthode de gestion des événements Paint du formulaire, en passant e comme 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

Remarques

Les embouts de ligne sont utilisés au début et à la fin des lignes ou des courbes dessinées par les objets GDI+ Pen.Line caps are used at the beginnings and ends of lines or curves drawn by GDI+ Pen objects. GDI+ prend en charge plusieurs styles d’extrémité prédéfinis et permet également aux utilisateurs de définir leurs propres styles d’extrémité.GDI+ supports several predefined cap styles, and also allows users to define their own cap styles. Cette classe est utilisée pour créer des styles d’extrémité personnalisés.This class is used to create custom cap styles.

Constructeurs

CustomLineCap(GraphicsPath, GraphicsPath)

Initialise une nouvelle instance de la classe CustomLineCap avec le contour et le remplissage spécifiés.Initializes a new instance of the CustomLineCap class with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap)

Initialise une nouvelle instance de la classe CustomLineCap à partir de l'énumération LineCap existante spécifiée avec le contour et le remplissage donnés.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)

Initialise une nouvelle instance de la classe CustomLineCap à partir de l'énumération LineCap existante spécifiée avec le contour, le remplissage et l'incrustation donnés.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline, fill, and inset.

Propriétés

BaseCap

Obtient ou définit l'énumération LineCap sur laquelle se base ce CustomLineCap.Gets or sets the LineCap enumeration on which this CustomLineCap is based.

BaseInset

Obtient ou définit la distance entre l'embout et la ligne.Gets or sets the distance between the cap and the line.

StrokeJoin

Obtient ou définit l'énumération LineJoin qui détermine la manière dont les lignes qui composent cet objet CustomLineCap sont jointes.Gets or sets the LineJoin enumeration that determines how lines that compose this CustomLineCap object are joined.

WidthScale

Obtient ou définit la proportion selon laquelle ajuster cet objet Class CustomLineCap par rapport à la largeur de l'objet Pen.Gets or sets the amount by which to scale this CustomLineCap Class object with respect to the width of the Pen object.

Méthodes

Clone()

Crée une copie exacte de CustomLineCap.Creates an exact copy of this CustomLineCap.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par cet objet CustomLineCap.Releases all resources used by this CustomLineCap object.

Dispose(Boolean)

Libère les ressources non managées utilisées par CustomLineCap et libère éventuellement les ressources managées.Releases the unmanaged resources used by the CustomLineCap and optionally releases the managed resources.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Finalize()

Autorise CustomLineCap à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant que CustomLineCap soit récupéré par l'opération garbage collection.Allows an CustomLineCap to attempt to free resources and perform other cleanup operations before the CustomLineCap is reclaimed by garbage collection.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)

Obtient les embouts utilisés au début et à la fin des lignes qui constituent cet embout personnalisé.Gets the caps used to start and end lines that make up this custom cap.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)

Définit les embouts utilisés au début et à la fin des lignes qui constituent cet embout personnalisé.Sets the caps used to start and end lines that make up this custom cap.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à