CustomLineCap Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

CustomLineCap.cs

Hermetyzuje niestandardowy limit wiersza zdefiniowany przez użytkownika.

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

Dziedziczenie

Object

MarshalByRefObject

CustomLineCap

Pochodne

System.Drawing.Drawing2D.AdjustableArrowCap

Implementuje

ICloneable IDisposable

Przykłady

W poniższym przykładzie pokazano, jak używać CustomLineCap klasy. Aby uruchomić ten przykład, wklej kod do formularza systemu Windows. Obsługa Paint zdarzenia formularza i wywołanie DrawCaps z metody obsługi zdarzeń formularza Paint , przekazując e jako 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

Uwagi

Czapki liniowe są używane na początku i końcach linii lub krzywych rysowanych przez obiekty GDI+ Pen . Interfejs GDI+ obsługuje kilka wstępnie zdefiniowanych stylów czapki, a także umożliwia użytkownikom definiowanie własnych stylów czapki. Ta klasa służy do tworzenia niestandardowych stylów czapki.

Uwaga

W programach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

CustomLineCap(GraphicsPath, GraphicsPath)	Inicjuje CustomLineCap nowe wystąpienie klasy o określonym konspekcie i wypełnieniu.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap)	Inicjuje nowe wystąpienie CustomLineCap klasy z określonego istniejącego LineCap wyliczenia z określonym konspektem i wypełnieniem.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)	Inicjuje CustomLineCap nowe wystąpienie klasy z określonego istniejącego LineCap wyliczenia z określonym konspektem, wypełnieniem i zestawem.

Właściwości

BaseCap	Pobiera lub ustawia wyliczenie LineCap , na podstawie którego jest to CustomLineCap oparte.
BaseInset	Pobiera lub ustawia odległość między czapką a linią.
StrokeJoin	Pobiera lub ustawia wyliczenie LineJoin , które określa sposób łączenia wierszy tworzących ten CustomLineCap obiekt.
WidthScale	Pobiera lub ustawia ilość, o jaką należy skalować ten CustomLineCap obiekt Klasy w odniesieniu do szerokości Pen obiektu.

Metody

Clone()	Tworzy dokładną kopię tego elementu CustomLineCap.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten CustomLineCap obiekt.
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element CustomLineCap i opcjonalnie zwalnia zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Finalize()	CustomLineCap Umożliwia próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed CustomLineCap odzyskaniem przez odzyskiwanie pamięci.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)	Pobiera czapki używane do uruchamiania i kończenia wierszy tworzących ten niestandardowy limit.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)	Ustawia limity używane do uruchamiania i kończenia wierszy tworzących ten limit niestandardowy.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)