CustomLineCap Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Source:

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 w formularzu systemu Windows. Obsłuż zdarzenie formularza Paint i wywołaj DrawCaps je 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 limitu, a także umożliwia użytkownikom definiowanie własnych stylów cap. Ta klasa służy do tworzenia niestandardowych stylów cap.

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje 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 za pomocą określonego konspektu i wypełnienia.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap)	Inicjuje nowe wystąpienie CustomLineCap klasy z określonego istniejącego LineCap wyliczenia z określonego konspektu i wypełnienia.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)	Inicjuje nowe wystąpienie CustomLineCap klasy z określonego istniejącego LineCap wyliczenia z określonym konspektem, wypełnieniem i zestawem.

Właściwości

BaseCap	Pobiera lub ustawia LineCap wyliczenie, na którym CustomLineCap jest oparta.
BaseInset	Pobiera lub ustawia odległość między czapką a linią.
StrokeJoin	Pobiera lub ustawia LineJoin wyliczenie określające 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()	Umożliwia próbę CustomLineCap zwolnienia zasobów i wykonania innych operacji oczyszczania przed odzyskaniem CustomLineCap pamięci 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, które tworzą ten niestandardowy limit.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad 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, które tworzą ten niestandardowy limit.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)