Język

CustomLineCap Klasa

Definicja

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
CustomLineCap
Pochodne
Implementuje

Przykłady

W poniższym przykładzie pokazano, jak używać CustomLineCap klasy . Aby uruchomić ten przykład, wklej kod do formularza 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 na 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 limitu. Ta klasa służy do tworzenia niestandardowych stylów limitu.

Note

W wersjach .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 supported only on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

Nazwa Opis
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.

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)

Inicjuje CustomLineCap nowe wystąpienie klasy z określonym konspektem i wypełnieniem.

Właściwości

Nazwa Opis
BaseCap

Pobiera lub ustawia LineCap wyliczenie, na którym CustomLineCap jest oparta.

BaseInset

Pobiera lub ustawia odległość między limitem 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

Nazwa Opis
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 niezarządzane zasoby używane przez CustomLineCap program i opcjonalnie zwalnia zarządzane zasoby.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(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()
Przestarzałe.

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 limity używane do uruchamiania i kończenia wierszy tworzących ten niestandardowy limit.

GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

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 Object.

(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 niestandardowy limit.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy