Pen 類別

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

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 建構 ，以及在 上Pen設定 LineJoin 屬性的效果。

此範例的設計目的是要與 Windows Forms 搭配使用。 將程式代碼貼到表單中，並在處理表單的事件Paint時呼叫 ShowLineJoin 方法，並傳遞e為 PaintEventArgs。

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 和更新版本中，只有 Windows 作業系統才支援包含此類型的 System.Drawing.Common 套件。 在跨平臺應用程式中使用此類型會導致編譯時間警告和運行時間例外狀況。 如需詳細資訊，請參閱 僅限 Windows 上支援的 System.Drawing.Common。

建構函式

Pen(Brush)	使用指定的 Pen 初始化 Brush 類別的新執行個體。
Pen(Brush, Single)	使用指定的 Pen 和 Brush，初始化 Width 類別的新執行個體。
Pen(Color)	使用指定的色彩，初始化 Pen 類別的新執行個體。
Pen(Color, Single)	使用指定的 Color 和 Width 屬性，初始化 Pen 類別的新執行個體。

屬性

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)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放這個 Pen 所使用的所有資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
MultiplyTransform(Matrix)	將這個 Pen 的轉換矩陣乘以指定的 Matrix。
MultiplyTransform(Matrix, MatrixOrder)	依照指定的順序，將這個 Pen 的轉換矩陣乘以指定的 Matrix。
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)	依照指定的順序，根據指定的順序來轉換局部幾何轉換。