CustomLineCap Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Encapsule une limite de ligne personnalisée définie 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
- Dérivé
- Implémente
Exemples
L’exemple suivant montre comment utiliser la CustomLineCap classe. Pour exécuter cet exemple, collez le code dans un formulaire Windows. Gérez l’événement et l’appel du Paint formulaire à partir de la méthode de gestion des événements du Paint formulaire, en passant e en tant que PaintEventArgs.DrawCaps
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 ligne sont utilisées au début et aux extrémités des lignes ou des courbes dessinées par des objets GDI+ Pen . GDI+ prend en charge plusieurs styles de limite prédéfinis et permet également aux utilisateurs de définir leurs propres styles de limite. Cette classe est utilisée pour créer des styles de limite personnalisés.
Note
Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, n’est pris en charge que 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
| Nom | Description |
|---|---|
| CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) |
Initialise une nouvelle instance de la CustomLineCap classe à partir de l’énumération existante LineCap spécifiée avec le plan, le remplissage et l’ensemble spécifiés. |
| CustomLineCap(GraphicsPath, GraphicsPath, LineCap) |
Initialise une nouvelle instance de la CustomLineCap classe à partir de l’énumération existante LineCap spécifiée avec le plan et le remplissage spécifiés. |
| CustomLineCap(GraphicsPath, GraphicsPath) |
Initialise une nouvelle instance de la CustomLineCap classe avec le plan et le remplissage spécifiés. |
Propriétés
| Nom | Description |
|---|---|
| BaseCap |
Obtient ou définit l’énumération LineCap sur laquelle elle CustomLineCap est basée. |
| BaseInset |
Obtient ou définit la distance entre la limite et la ligne. |
| StrokeJoin |
Obtient ou définit l’énumération LineJoin qui détermine la façon dont les lignes qui composent cet CustomLineCap objet sont jointes. |
| WidthScale |
Obtient ou définit la quantité par laquelle mettre à l’échelle cet CustomLineCap objet Class par rapport à la largeur de l’objet Pen . |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée une copie exacte de ce CustomLineCap. |
| CreateObjRef(Type) |
Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject) |
| Dispose() |
Libère toutes les ressources utilisées par cet CustomLineCap objet. |
| Dispose(Boolean) |
Libère les ressources non managées utilisées par les CustomLineCap ressources gérées 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() |
Permet d’essayer CustomLineCap de libérer des ressources et d’effectuer d’autres opérations de nettoyage avant la CustomLineCap récupération par le garbage collection. |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetLifetimeService() |
Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject) |
| GetStrokeCaps(LineCap, LineCap) |
Obtient les majuscules utilisées pour démarrer et terminer les lignes qui composent cette limite personnalisée. |
| GetType() |
Obtient la 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 Objectactuel. (Hérité de Object) |
| MemberwiseClone(Boolean) |
Crée une copie superficielle de l’objet actuel MarshalByRefObject . (Hérité de MarshalByRefObject) |
| SetStrokeCaps(LineCap, LineCap) |
Définit les majuscules utilisées pour démarrer et terminer les lignes qui composent cette limite personnalisée. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |