CustomLineCap CustomLineCap CustomLineCap CustomLineCap Class

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

Przykłady

Poniższy przykład ilustruje sposób użycia CustomLineCap klasy.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 Paint zdarzenie formularza i wywołanie DrawCaps z metody obsługi Paint zdarzeń 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 obiekty GDI+ Pen 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) CustomLineCap(GraphicsPath, GraphicsPath) CustomLineCap(GraphicsPath, GraphicsPath) CustomLineCap(GraphicsPath, GraphicsPath)

Inicjuje nowe wystąpienie CustomLineCap klasy o określonym konspekcie i wypełnieniu.Initializes a new instance of the CustomLineCap class with the specified outline and fill.

CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap) CustomLineCap(GraphicsPath, GraphicsPath, LineCap)

Inicjuje nowe wystąpienie CustomLineCap klasy z LineCap określonego wyliczenia o określonym konspekcie i Fill.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) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single) CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)

Inicjuje nowe wystąpienie CustomLineCap klasy z LineCap określonego wyliczenia 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 BaseCap BaseCap BaseCap

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

BaseInset BaseInset BaseInset BaseInset

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

StrokeJoin StrokeJoin StrokeJoin StrokeJoin

Pobiera lub ustawia LineJoin Wyliczenie określające sposób przyłączenia wierszy, które CustomLineCap tworzą ten obiekt.Gets or sets the LineJoin enumeration that determines how lines that compose this CustomLineCap object are joined.

WidthScale WidthScale WidthScale WidthScale

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

Metody

Clone() Clone() Clone() Clone()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) 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.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Umożliwia próbę zwolnienia zasobów i wykonywanie innych operacji czyszczenia CustomLineCap przed odzyskiwaniem danych przez wyrzucanie elementów bezużytecznych. CustomLineCapAllows an CustomLineCap to attempt to free resources and perform other cleanup operations before the CustomLineCap is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap) GetStrokeCaps(LineCap, LineCap) GetStrokeCaps(LineCap, LineCap) 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() GetType() GetType() GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap) SetStrokeCaps(LineCap, LineCap) SetStrokeCaps(LineCap, LineCap) 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() ToString() ToString() ToString()

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

(Inherited from Object)

Dotyczy