CustomLineCap Třída

Definice

Obor názvů:

System.Drawing.Drawing2D

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

CustomLineCap.cs

Zapouzdří vlastní uživatelem definovaný limit řádku.

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

Dědičnost

Object

MarshalByRefObject

CustomLineCap

Odvozené

System.Drawing.Drawing2D.AdjustableArrowCap

Implementuje

ICloneable IDisposable

Příklady

Následující příklad ukazuje, jak použít CustomLineCap třídu. Pokud chcete spustit tento příklad, vložte kód do formuláře Windows Form. Zpracování události formuláře Paint a volání DrawCaps z metody zpracování událostí formuláře Paint , předání 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

Poznámky

Konce čar se používají na začátku a koncích čar nebo křivek nakreslených objekty GDI+ Pen . Rozhraní GDI+ podporuje několik předdefinovaných stylů cap a také umožňuje uživatelům definovat vlastní styly cap. Tato třída se používá k vytvoření vlastních stylů cap.

Poznámka

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění při kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Konstruktory

CustomLineCap(GraphicsPath, GraphicsPath)	Inicializuje novou instanci CustomLineCap třídy pomocí zadané osnovy a výplně.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap)	Inicializuje novou instanci CustomLineCap třídy ze zadaného existujícího LineCap výčtu pomocí zadané osnovy a výplně.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)	Inicializuje novou instanci CustomLineCap třídy ze zadaného existujícího LineCap výčtu pomocí zadané osnovy, výplně a inset.

Vlastnosti

BaseCap	Získá nebo nastaví LineCap výčet, na kterém je založen CustomLineCap .
BaseInset	Získá nebo nastaví vzdálenost mezi uzávěrem a čárou.
StrokeJoin	Získá nebo nastaví LineJoin výčet, který určuje, jak řádky, které tvoří tento CustomLineCap objekt jsou spojeny.
WidthScale	Získá nebo nastaví množství, o které chcete škálovat tento CustomLineCap class objekt s ohledem na šířku objektu Pen .

Metody

Clone()	Vytvoří přesnou kopii tohoto CustomLineCapobjektu .
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané tímto CustomLineCap objektem.
Dispose(Boolean)	Uvolní nespravované prostředky používané CustomLineCap nástrojem a volitelně uvolní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Finalize()	CustomLineCap Umožňuje pokusit se uvolnit prostředky a provést další operace čištění před CustomLineCap uvolněním paměti uvolňováním paměti.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)	Získá horní čáry použité pro počáteční a koncové řádky, které tvoří toto vlastní cap.
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)	Nastaví horní čáry použité pro počáteční a koncové řádky, které tvoří toto vlastní omezení.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)