CustomLineCap 类

定义

命名空间:

System.Drawing.Drawing2D

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

CustomLineCap.cs

封装自定义的用户定义的线帽。

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

继承

Object

MarshalByRefObject

CustomLineCap

派生

System.Drawing.Drawing2D.AdjustableArrowCap

实现

ICloneable IDisposable

示例

下面的示例演示如何使用 CustomLineCap 类。 若要运行此示例，请将代码粘贴到 Windows 窗体中。 处理窗体的 Paint 事件，并从窗体的事件Paint处理方法调用 DrawCaps ，并e作为 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

注解

线帽用于 GDI+ Pen 对象绘制的线条或曲线的起点和终点。 GDI+ 支持多种预定义的 cap 样式，还允许用户定义自己的大写字母样式。 此类用于创建自定义大写字母样式。

注意

在 .NET 6 及更高版本中， System.Drawing.Common 包（包括此类型）仅在 Windows 操作系统上受支持。 在跨平台应用中使用此类型会导致编译时警告和运行时异常。 有关详细信息，请参阅 System.Drawing.Common 仅在 Windows 上受支持。

构造函数

CustomLineCap(GraphicsPath, GraphicsPath)	使用指定的轮廓和填充初始化 CustomLineCap 类的新实例。
CustomLineCap(GraphicsPath, GraphicsPath, LineCap)	通过指定的轮廓和填充从指定的现有 CustomLineCap 枚举初始化 LineCap 类的新实例。
CustomLineCap(GraphicsPath, GraphicsPath, LineCap, Single)	通过指定的轮廓、填充和嵌入从指定的现有 CustomLineCap 枚举初始化 LineCap 类的新实例。

属性

BaseCap	获取或设置该 LineCap 所基于的 CustomLineCap 枚举。
BaseInset	获取或设置线帽和直线之间的距离。
StrokeJoin	获取或设置 LineJoin 枚举，该枚举确定如何联接构成此 CustomLineCap 对象的直线。
WidthScale	获取或设置相对于 CustomLineCap 对象的宽度此 Pen 类对象的缩放量。

方法

Clone()	创建此 CustomLineCap 的一个精确副本。
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放由此 CustomLineCap 对象使用的所有资源。
Dispose(Boolean)	释放由 CustomLineCap 占用的非托管资源，还可以另外再释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Finalize()	允许 CustomLineCap 在"垃圾回收"回收 CustomLineCap 之前尝试释放资源并执行其他清理操作。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetStrokeCaps(LineCap, LineCap)	获取用于构成此自定义线帽的起始直线和结束直线的线帽。
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
SetStrokeCaps(LineCap, LineCap)	设置用于构成此自定义线帽的起始直线和结束直线的线帽。
ToString()	返回表示当前对象的字符串。 (继承自 Object)