Pen 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义用于绘制直线和曲线的对象。 此类不能被继承。
public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposablepublic sealed class Pen : MarshalByRefObject, ICloneable, IDisposabletype Pen = class
inherit MarshalByRefObject
interface ICloneable
interface IDisposablePublic NotInheritable Class Pen
Inherits MarshalByRefObject
Implements 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, Single) | |
| Pen(Color) |
用指定颜色初始化 Pen 类的新实例。 |
| Pen(Color, Single) |
属性
| Alignment |
获取或设置此 Pen 的对齐方式。 |
| Brush | |
| 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 |
