Pen Sınıf

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Kaynak:

Pen.cs

Çizgileri ve eğrileri çizmek için kullanılan bir nesneyi tanımlar. Bu sınıf devralınamaz.

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

Devralma

Object

MarshalByRefObject

Pen

Uygulamalar

ICloneable IDisposable

Örnekler

Aşağıdaki kod örneği ile oluşturma PenBrush işlemini ve özelliğini bir Penüzerinde ayarlamanın LineJoin etkilerini gösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun ShowLineJoinPaint olayını işlerken yöntemini çağırın e ve olarak geçirin 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

Açıklamalar

, Pen belirtilen genişlik ve stilde bir çizgi çizer. DashStyle Çeşitli kesikli çizgiler çizmek için özelliğini kullanın. tarafından çizilen Pen çizgi, düz renkler ve dokular da dahil olmak üzere çeşitli dolgu stilleriyle doldurulabilir. Dolgu stili, dolgu nesnesi olarak kullanılan fırçaya veya dokuya bağlıdır.

Not

.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketi yalnızca Windows işletim sistemlerinde desteklenir. Platformlar arası uygulamalarda bu türün kullanılması derleme zamanı uyarılarına ve çalışma zamanı özel durumlarına neden olur. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.

Oluşturucular

Pen(Brush)	belirtilen Brushile sınıfının yeni bir örneğini Pen başlatır.
Pen(Brush, Single)	belirtilen Brush ve Widthile sınıfının yeni bir örneğini Pen başlatır.
Pen(Color)	Belirtilen renkle sınıfının yeni bir örneğini Pen başlatır.
Pen(Color, Single)	Belirtilen Color ve Width özellikleriyle sınıfının yeni bir örneğini Pen başlatır.

Özellikler

Alignment	Bu Peniçin hizalamayı alır veya ayarlar.
Brush	Bu Penöğesinin Brush özniteliklerini belirleyen öğesini alır veya ayarlar.
Color	Bu Penöğesinin rengini alır veya ayarlar.
CompoundArray	Bileşik kalemi belirten bir değer dizisini alır veya ayarlar. Bileşik kalem, paralel çizgilerden ve boşluklardan oluşan bir bileşik çizgi çizer.
CustomEndCap	Bu Penile çizilen satırların sonunda kullanılacak özel bir üst sınır alır veya ayarlar.
CustomStartCap	Bu Penile çizilen çizgilerin başında kullanılacak özel bir büyük harf alır veya ayarlar.
DashCap	Bu Penile çizilen kesikli çizgileri oluşturan tirelerin sonunda kullanılan başlık stilini alır veya ayarlar.
DashOffset	Çizginin başından tire deseninin başına kadar olan uzaklığı alır veya ayarlar.
DashPattern	Özel tire ve boşluk dizisini alır veya ayarlar.
DashStyle	Bu Penile çizilen kesikli çizgiler için kullanılan stili alır veya ayarlar.
EndCap	Bu Penile çizilen çizgilerin sonunda kullanılan cap stilini alır veya ayarlar.
LineJoin	Bu Penile çizilmiş ardışık iki satırın uçları için birleştirme stilini alır veya ayarlar.
MiterLimit	Caydırılan bir köşedeki birleştirme kalınlığı sınırını alır veya ayarlar.
PenType	Bu Penile çizilen çizgilerin stilini alır.
StartCap	Bu Penile çizilen çizgilerin başında kullanılan cap stilini alır veya ayarlar.
Transform	Bu Peniçin geometrik dönüşümün bir kopyasını alır veya ayarlar.
Width	Çizim için kullanılan nesnenin birimlerinde bu Penöğesinin Graphics genişliğini alır veya ayarlar.

Yöntemler

Clone()	Bu Penöğesinin tam bir kopyasını oluşturur.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Bu Pentarafından kullanılan tüm kaynakları serbest bırakır.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Finalize()	Bir nesnenin atık toplama tarafından geri kazanılmadan önce kaynakları boşaltmaya ve diğer temizleme işlemlerini gerçekleştirmeye çalışmasına izin verir.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MultiplyTransform(Matrix)	Bunun Pen dönüştürme matrisini belirtilen Matrixile çarpar.
MultiplyTransform(Matrix, MatrixOrder)	Bunun Pen dönüştürme matrisini belirtilen sırada belirtilen Matrix ile çarpar.
ResetTransform()	Bunun Pen geometrik dönüşüm matrisini kimliğe sıfırlar.
RotateTransform(Single)	Yerel geometrik dönüşümü belirtilen açıya göre döndürür. Bu yöntem dönüştürmeye döndürmenin başına ekler.
RotateTransform(Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen açıya göre döndürür.
ScaleTransform(Single, Single)	Yerel geometrik dönüşümü belirtilen faktörlere göre ölçeklendirir. Bu yöntem ölçeklendirme matrisini dönüştürmeye ekler.
ScaleTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen faktörlere göre ölçeklendirir.
SetLineCap(LineCap, LineCap, DashCap)	Bu Pentarafından çizilen çizgileri sonlandırmak için kullanılan cap stilini belirleyen değerleri ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TranslateTransform(Single, Single)	Yerel geometrik dönüşümü belirtilen boyutlara çevirir. Bu yöntem, dönüştürmeye çevirinin başına ekler.
TranslateTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen boyutlara çevirir.