CustomLineCap Kelas

Definisi

Ruang nama:

System.Drawing.Drawing2D

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

CustomLineCap.cs

Merangkum batas baris yang ditentukan pengguna kustom.

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

Warisan

Object

MarshalByRefObject

CustomLineCap

Turunan

System.Drawing.Drawing2D.AdjustableArrowCap

Penerapan

ICloneable IDisposable

Contoh

Contoh berikut menunjukkan cara menggunakan CustomLineCap kelas . Untuk menjalankan contoh ini, tempelkan kode ke dalam Formulir Windows. Tangani peristiwa formulir Paint dan panggil DrawCaps dari metode penanganan peristiwa formulir Paint , meneruskan e sebagai 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

Keterangan

Batas garis digunakan di awal dan akhir garis atau kurva yang digambar oleh objek GDI+ Pen . GDI+ mendukung beberapa gaya tutup yang telah ditentukan sebelumnya, dan juga memungkinkan pengguna untuk menentukan gaya tutup mereka sendiri. Kelas ini digunakan untuk membuat gaya batas kustom.

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Konstruktor

CustomLineCap(GraphicsPath, GraphicsPath)	Menginisialisasi instans CustomLineCap baru kelas dengan kerangka dan isi yang ditentukan.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap)	Menginisialisasi instans CustomLineCap baru kelas dari enumerasi yang ada LineCap yang ditentukan dengan kerangka dan isi yang ditentukan.
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)	Menginisialisasi instans CustomLineCap baru kelas dari enumerasi yang ada LineCap yang ditentukan dengan kerangka, isi, dan inset yang ditentukan.

Properti

BaseCap	Mendapatkan atau mengatur LineCap enumerasi tempat ini CustomLineCap didasarkan.
BaseInset	Mendapatkan atau mengatur jarak antara batas dan garis.
StrokeJoin	Mendapatkan atau mengatur LineJoin enumerasi yang menentukan bagaimana baris yang menyusun objek ini CustomLineCap digabungkan.
WidthScale	Mendapatkan atau mengatur jumlah untuk menskalakan objek Kelas ini CustomLineCap sehubungan dengan lebar Pen objek.

Metode

Clone()	Membuat salinan yang tepat dari ini CustomLineCap.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Melepaskan semua sumber daya yang digunakan oleh objek ini CustomLineCap .
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang CustomLineCap digunakan oleh dan secara opsional merilis sumber daya terkelola.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Finalize()	CustomLineCap Memungkinkan upaya untuk membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum CustomLineCap direklamasi kembali oleh pengumpulan sampah.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)	Mendapatkan batas yang digunakan untuk memulai dan mengakhiri baris yang membentuk batas kustom ini.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)	Mengatur batas yang digunakan untuk memulai dan mengakhiri baris yang membentuk batas kustom ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)