Pen Kelas

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Sumber:

Pen.cs

Menentukan objek yang digunakan untuk menggambar garis dan kurva. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Pen

Penerapan

ICloneable IDisposable

Contoh

Contoh kode berikut menunjukkan pembuatan Pen dengan Brush dan efek pengaturan LineJoin properti pada Pen.

Contoh ini dirancang untuk digunakan dengan Windows Forms. Tempelkan kode ke dalam formulir dan panggil ShowLineJoin metode saat menangani peristiwa formulir Paint , meneruskan e sebagai 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

Keterangan

Menggambar Pen garis dengan lebar dan gaya yang ditentukan. DashStyle Gunakan properti untuk menggambar beberapa varietas garis putus-putus. Garis yang Pen digambar oleh dapat diisi dalam berbagai gaya isian, termasuk warna solid dan tekstur. Gaya isian tergantung pada kuas atau tekstur yang digunakan sebagai objek isian.

Nota

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

Nama	Deskripsi
Pen(Brush, Single)	Menginisialisasi instans Pen baru kelas dengan yang ditentukan Brush dan Width.
Pen(Brush)	Menginisialisasi instans Pen baru kelas dengan yang ditentukan Brush.
Pen(Color, Single)	Menginisialisasi instans Pen baru kelas dengan properti dan Width yang ditentukanColor.
Pen(Color)	Menginisialisasi instans Pen baru kelas dengan warna yang ditentukan.

Properti

Nama	Deskripsi
Alignment	Mendapatkan atau mengatur perataan untuk ini Pen.
Brush	Mendapatkan atau mengatur Brush yang menentukan atribut dari ini Pen.
Color	Mendapatkan atau mengatur warna ini Pen.
CompoundArray	Mendapatkan atau mengatur array nilai yang menentukan pena gabungan. Pena majemuk menggambar garis majemuk yang terdiri dari garis dan spasi paralel.
CustomEndCap	Mendapatkan atau mengatur batas kustom untuk digunakan di akhir baris yang digambar dengan ini Pen.
CustomStartCap	Mendapatkan atau mengatur batas kustom untuk digunakan di awal baris yang digambar dengan ini Pen.
DashCap	Mendapatkan atau mengatur gaya tutup yang digunakan di akhir tanda hubung yang membentuk garis putus-putus yang digambar dengan ini Pen.
DashOffset	Mendapatkan atau mengatur jarak dari awal garis ke awal pola tanda hubung.
DashPattern	Mendapatkan atau mengatur array tanda hubung dan spasi kustom.
DashStyle	Mendapatkan atau mengatur gaya yang digunakan untuk garis putus-putus yang digambar dengan ini Pen.
EndCap	Mendapatkan atau mengatur gaya batas yang digunakan di akhir garis yang digambar dengan ini Pen.
LineJoin	Mendapatkan atau mengatur gaya gabungan untuk akhir dua baris berturut-turut yang digambar dengan ini Pen.
MiterLimit	Mendapatkan atau menetapkan batas ketebalan gabungan di sudut yang bermigrasi.
PenType	Mendapatkan gaya garis yang digambar dengan ini Pen.
StartCap	Mendapatkan atau mengatur gaya tutup yang digunakan di awal garis yang digambar dengan ini Pen.
Transform	Mendapatkan atau mengatur salinan transformasi geometrik untuk ini Pen.
Width	Mendapatkan atau mengatur lebar ini Pen, dalam satuan objek yang Graphics digunakan untuk menggambar.

Metode

Nama	Deskripsi
Clone()	Membuat salinan yang tepat dari ini Pen.
Dispose()	Merilis semua sumber daya yang digunakan oleh ini Pen.
Finalize()	Memungkinkan objek untuk mencoba membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum direklamasi kembali oleh pengumpulan sampah.
MultiplyTransform(Matrix, MatrixOrder)	Mengalikan matriks transformasi untuk ini Pen dengan yang ditentukan Matrix dalam urutan yang ditentukan.
MultiplyTransform(Matrix)	Mengalikan matriks transformasi untuk ini Pen dengan yang ditentukan Matrix.
ResetTransform()	Mengatur ulang matriks transformasi geometrik untuk ini Pen ke identitas.
RotateTransform(Single, MatrixOrder)	Memutar transformasi geometrik lokal dengan sudut yang ditentukan dalam urutan yang ditentukan.
RotateTransform(Single)	Memutar transformasi geometrik lokal dengan sudut yang ditentukan. Metode ini menambahkan rotasi ke transformasi.
ScaleTransform(Single, Single, MatrixOrder)	Menskalakan transformasi geometrik lokal dengan faktor yang ditentukan dalam urutan yang ditentukan.
ScaleTransform(Single, Single)	Menskalakan transformasi geometrik lokal berdasarkan faktor yang ditentukan. Metode ini menambahkan matriks penskalaan ke transformasi.
SetLineCap(LineCap, LineCap, DashCap)	Mengatur nilai yang menentukan gaya batas yang digunakan untuk mengakhiri garis yang digambar oleh ini Pen.
TranslateTransform(Single, Single, MatrixOrder)	Menerjemahkan transformasi geometrik lokal dengan dimensi yang ditentukan dalam urutan yang ditentukan.
TranslateTransform(Single, Single)	Menerjemahkan transformasi geometrik lokal dengan dimensi yang ditentukan. Metode ini menangguhkan terjemahan ke transformasi.