CustomLineCap Classe
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Incapsula un delimitatore di linea personalizzato definito dall'utente.
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à
- Derivato
- Implementazioni
Nell'esempio riportato di seguito viene illustrato come utilizzare la classe CustomLineCap. Per eseguire questo esempio incollare il codice in un Windows Form. Gestire l'evento e la chiamata DrawCaps
del Paint modulo dal metodo di gestione degli eventi del Paint modulo, passando e
come 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
I limiti di linea vengono usati all'inizio e alle estremità di linee o curve disegnate da oggetti GDI+ Pen . GDI+ supporta diversi stili di limite predefiniti e consente anche agli utenti di definire i propri stili di limite. Questa classe viene usata per creare stili di limite personalizzati.
Nota
In .NET 6 e versioni successive il pacchetto System.Drawing.Common, che include questo tipo, è supportato solo nei sistemi operativi Windows. L'uso di questo tipo nelle app multipiattaforma causa avvisi in fase di compilazione e eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.
Custom |
Inizializza una nuova istanza della classe CustomLineCap con il contorno e il riempimento specificati. |
Custom |
Inizializza una nuova istanza della classe CustomLineCap dall'enumerazione LineCap esistente specificata con il contorno e il riempimento indicati. |
Custom |
Inizializza una nuova istanza della classe CustomLineCap dall'enumerazione LineCap esistente specificata con il contorno, riempimento e interno indicati. |
Base |
Ottiene o imposta l'enumerazione LineCap sulla quale si basa questo CustomLineCap. |
Base |
Ottiene o imposta la distanza tra il delimitatore e la linea. |
Stroke |
Ottiene o imposta l'enumerazione LineJoin che determina la modalità di unione delle linee che compongono questo oggetto CustomLineCap. |
Width |
Ottiene o imposta il valore in base al quale modificare le proporzioni di questo oggetto della classe CustomLineCap rispetto alla larghezza dell'oggetto Pen. |
Clone() |
Crea una copia esatta di questo CustomLineCap. |
Create |
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. (Ereditato da MarshalByRefObject) |
Dispose() |
Rilascia tutte le risorse usate dall'oggetto CustomLineCap. |
Dispose(Boolean) |
Rilascia le risorse non gestite usate da CustomLineCap e, facoltativamente, le risorse gestite. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (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. |
Get |
Funge da funzione hash predefinita. (Ereditato da Object) |
Get |
Obsoleti.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
Get |
Ottiene i delimitatori utilizzati per iniziare e terminare le linee che compongono questo delimitatore personalizzato. |
Get |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
Initialize |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
Memberwise |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
Memberwise |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
Set |
Imposta i delimitatori utilizzati per iniziare e terminare le linee che compongono questo delimitatore personalizzato. |
To |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Prodotto | Versioni |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Feedback su .NET
.NET è un progetto di open source. Selezionare un collegamento per fornire feedback: