CustomLineCap Klasa

Definicja

Hermetyzuje niestandardowy limit wiersza zdefiniowany przez użytkownika.Encapsulates a custom user-defined line cap.

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

Poniższy przykład ilustruje sposób użycia klasy CustomLineCap.The following example demonstrates how to use the CustomLineCap class. Aby uruchomić ten przykład, należy wkleić kod do formularza systemu Windows.To run this example paste, the code into a Windows Form. Obsługuj zdarzenie Paint formularza i Wywołaj DrawCaps z metody obsługi zdarzeń Paint formularza, przekazując e jako PaintEventArgs.Handle the form's Paint event and call DrawCaps from the form's Paint event-handling method, passing e as 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

Na początku i na końcach linii lub krzywych rysowanych przez GDI+ Pen obiekty są używane wielkie litery.Line caps are used at the beginnings and ends of lines or curves drawn by GDI+ Pen objects. Interfejs GDI+ obsługuje kilka wstępnie zdefiniowanych stylów Cap, a także umożliwia użytkownikom Definiowanie własnych stylów Cap.GDI+ supports several predefined cap styles, and also allows users to define their own cap styles. Ta klasa jest używana do tworzenia niestandardowych stylów zakończenia.This class is used to create custom cap styles.

Konstruktory

CustomLineCap(GraphicsPath, GraphicsPath)

Inicjuje nowe wystąpienie klasy CustomLineCap przy użyciu określonego konspektu i wypełnienia.Initializes a new instance of the CustomLineCap class with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap)

Inicjuje nowe wystąpienie klasy CustomLineCap z określonego istniejącego wyliczenia LineCap o określonym konspekcie i wypełnieniu.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)

Inicjuje nowe wystąpienie klasy CustomLineCap z określonego istniejącego wyliczenia LineCap z określonym konturem, wypełnieniem i marginesem.Initializes a new instance of the CustomLineCap class from the specified existing LineCap enumeration with the specified outline, fill, and inset.

Właściwości

BaseCap

Pobiera lub ustawia Wyliczenie LineCap, na którym bazuje ten CustomLineCap.Gets or sets the LineCap enumeration on which this CustomLineCap is based.

BaseInset

Pobiera lub ustawia odległość między limitem a wierszem.Gets or sets the distance between the cap and the line.

StrokeJoin

Pobiera lub ustawia Wyliczenie LineJoin, które określa sposób, w jaki wiersze tworzące ten obiekt CustomLineCap są dołączone.Gets or sets the LineJoin enumeration that determines how lines that compose this CustomLineCap object are joined.

WidthScale

Pobiera lub ustawia liczbę, według której ma być skalowany ten obiekt klasy CustomLineCap w odniesieniu do szerokości obiektu Pen.Gets or sets the amount by which to scale this CustomLineCap Class object with respect to the width of the Pen object.

Metody

Clone()

Tworzy dokładną kopię tego CustomLineCap.Creates an exact copy of this CustomLineCap.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez ten obiekt CustomLineCap.Releases all resources used by this CustomLineCap object.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element CustomLineCap i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the CustomLineCap and optionally releases the managed resources.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Finalize()

Umożliwia CustomLineCap próby zwolnienia zasobów i wykonania innych operacji oczyszczania przed odinstalowaniem CustomLineCap przez wyrzucanie elementów bezużytecznych.Allows an CustomLineCap to attempt to free resources and perform other cleanup operations before the CustomLineCap is reclaimed by garbage collection.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)

Pobiera wersaliki używane do uruchamiania i kończenia wierszy, które tworzą ten niestandardowy limit.Gets the caps used to start and end lines that make up this custom cap.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)

Ustawia wersaliki używane do uruchamiania i kończenia wierszy, które tworzą ten niestandardowy limit.Sets the caps used to start and end lines that make up this custom cap.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy