Pen 类

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

Pen.cs

定义用于绘制直线和曲线的对象。 此类不能被继承。

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable

public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable

type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable

Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable

继承

Object

MarshalByRefObject

Pen

实现

ICloneable IDisposable

示例

下面的代码示例演示如何使用 构造 ，PenBrush以及设置 LineJoin 上 Pen属性的效果。

此示例旨在与 Windows 窗体 一起使用。 将代码粘贴到窗体中， ShowLineJoin 并在处理窗体 Paint 的事件时调用 方法，作为 ePaintEventArgs传递。

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

注解

绘制 Pen 具有指定宽度和样式的线条。 DashStyle使用 属性绘制多个品种的虚线。 绘制的 Pen 线条可以填充各种填充样式，包括纯色和纹理。 填充样式取决于用作填充对象的画笔或纹理。

注意

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

构造函数

Pen(Brush)	使用指定的 Pen 初始化 Brush 类的新实例。
Pen(Brush, Single)	使用指定的 Pen 和 Brush 初始化 Width 类的新实例。
Pen(Color)	用指定颜色初始化 Pen 类的新实例。
Pen(Color, Single)	用指定的 Pen 和 Color 属性初始化 Width 类的新实例。

属性

Alignment	获取或设置此 Pen 的对齐方式。
Brush	获取或设置 Brush，用于确定此 Pen 的特性。
Color	获取或设置此 Pen 的颜色。
CompoundArray	获取或设置用于指定复合钢笔的值数组。 复合钢笔绘制由平行直线和空白区域组成的复合直线。
CustomEndCap	获取或设置要在通过此 Pen 绘制的直线终点使用的自定义线帽。
CustomStartCap	获取或设置要在通过此 Pen 绘制的直线起点使用的自定义线帽。
DashCap	获取或设置用在短划线终点的线帽样式，这些短划线构成通过此 Pen 绘制的虚线。
DashOffset	获取或设置直线的起点到短划线图案起始处的距离。
DashPattern	获取或设置自定义的短划线和空白区域的数组。
DashStyle	获取或设置用于通过此 Pen 绘制的虚线的样式。
EndCap	获取或设置要在通过此 Pen 绘制的直线终点使用的线帽样式。
LineJoin	获取或设置通过此 Pen 绘制的两条连续直线的端点的联接样式。
MiterLimit	获取或设置斜接角上联接宽度的限制。
PenType	获取用此 Pen 绘制的直线的样式。
StartCap	获取或设置在通过此 Pen 绘制的直线起点使用的线帽样式。
Transform	获取或设置此 Pen 的几何变换的副本。
Width	获取或设置此 Pen 的宽度，以用于绘图的 Graphics 对象为单位。

方法

Clone()	创建此 Pen 的一个精确副本。
CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放此 Pen 使用的所有资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Finalize()	在垃圾回收将某一对象回收前允许该对象尝试释放资源并执行其他清理操作。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetType()	获取当前实例的 Type。 (继承自 Object)
InitializeLifetimeService()	获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
MultiplyTransform(Matrix)	用指定的 Matrix 乘以此 Pen 的转换矩阵。
MultiplyTransform(Matrix, MatrixOrder)	按照指定的顺序，用指定的 Matrix 乘以此 Pen 的变换矩阵。
ResetTransform()	将此 Pen 的几何变换矩阵重置为单位矩阵。
RotateTransform(Single)	将局部几何转换旋转指定角度。 此方法将旋转添加到转换前。
RotateTransform(Single, MatrixOrder)	以指定顺序将局部几何变换旋转指定角度。
ScaleTransform(Single, Single)	按指定因子缩放局部几何变换。 此方法将缩放矩阵添加到转换前。
ScaleTransform(Single, Single, MatrixOrder)	将局部几何变换以指定顺序缩放指定因子。
SetLineCap(LineCap, LineCap, DashCap)	设置用于确定线帽样式的值，线帽用于结束通过此 Pen 绘制的直线。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TranslateTransform(Single, Single)	将局部几何转换平移指定尺寸。 此方法将平移添加到转换前。
TranslateTransform(Single, Single, MatrixOrder)	按指定的顺序将局部几何变换平移指定的尺寸。