CustomLineCap Classe

Définition

Espace de noms:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

CustomLineCap.cs

Encapsule un embout de ligne personnalisé défini par l'utilisateur.

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

Object

MarshalByRefObject

CustomLineCap

Dérivé

System.Drawing.Drawing2D.AdjustableArrowCap

Implémente

ICloneable IDisposable

Exemples

L'exemple suivant montre comment utiliser la classe CustomLineCap. Pour exécuter cet exemple, collez le code dans un Windows Form. Gérez l’événement et l’appel DrawCaps du Paint formulaire à partir de la méthode de gestion des événements du Paint formulaire, en passant e comme 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 majuscules de trait sont utilisées au début et à la fin des lignes ou des courbes dessinées par des objets GDI+ Pen . GDI+ prend en charge plusieurs styles de majuscules prédéfinis et permet également aux utilisateurs de définir leurs propres styles de majuscule. Cette classe est utilisée pour créer des styles de majuscules personnalisés.

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est pris en charge uniquement sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

CustomLineCap(GraphicsPath, GraphicsPath)	Initialise une nouvelle instance de la classe CustomLineCap avec le contour et le remplissage spécifiés.
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.
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.

Propriétés

BaseCap	Obtient ou définit l'énumération LineCap sur laquelle se base ce CustomLineCap.
BaseInset	Obtient ou définit la distance entre l'embout et la ligne.
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.
WidthScale	Obtient ou définit la proportion selon laquelle ajuster cet objet Class CustomLineCap par rapport à la largeur de l'objet Pen.

Méthodes

Clone()	Crée une copie exacte de 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. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par cet objet CustomLineCap.
Dispose(Boolean)	Libère les ressources non managées utilisées par CustomLineCap et libère éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (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.
GetHashCode()	Fait office de fonction de hachage par défaut. (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. (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é.
GetType()	Obtient le Type de l'instance actuelle. (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. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (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é.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)