Pen Sınıf

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-rc.2.24474.1

Kaynak:

Pen.cs

Çizgileri ve eğrileri çizmek için kullanılan 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, Brush ile bir Pen oluşturmayı ve PenLineJoin özelliğini ayarlamanın etkilerini gösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun Paint olayını işlerken ePaintEventArgsolarak geçirerek ShowLineJoin yöntemini çağırın.

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. Çeşitli kesikli çizgi çeşitleri çizmek için DashStyle özelliğini kullanın. Bir Pen tarafından çizilen ç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 paketiyalnı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'da desteklenir.

Oluşturucular

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

Özellikler

Alignment	Bu Penhizalamasını alır veya ayarlar.
Brush	Bu Penözniteliklerini belirleyen Brush alır veya ayarlar.
Color	Bu Penrengini 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 bileşik bir çizgi çizer.
CustomEndCap	Bu Penç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 üst sınır 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 mesafeyi alır veya ayarlar.
DashPattern	Özel tireler ve boşluklar dizisi alır veya ayarlar.
DashStyle	Bu Pençizilen kesikli çizgiler için kullanılan stili alır veya ayarlar.
EndCap	Bu Penile çizilen çizgilerin sonunda kullanılan başlık stilini alır veya ayarlar.
LineJoin	Bu Penile çizilen ardışık iki satırın uçları için birleştirme stilini alır veya ayarlar.
MiterLimit	Caydırılmış bir köşedeki birleştirme kalınlığının 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 başlık stilini alır veya ayarlar.
Transform	Bu Peniçin geometrik dönüşümün bir kopyasını alır veya ayarlar.
Width	Bu Pengenişliğini, çizim için kullanılan Graphics nesnesinin birimlerinde alır veya ayarlar.

Yöntemler

Clone()	Bu Pentam 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()	Geçersiz. 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MultiplyTransform(Matrix, MatrixOrder)	Bu Pen dönüştürme matrisini belirtilen sırada belirtilen Matrix çarpar.
MultiplyTransform(Matrix)	Bu Pen için dönüştürme matrisini belirtilen Matrixçarpar.
ResetTransform()	Bu Pen için geometrik dönüştürme matrisini kimliğe sıfırlar.
RotateTransform(Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen açıya göre döndürür.
RotateTransform(Single)	Yerel geometrik dönüşümü belirtilen açıya göre döndürür. Bu yöntem, döndürmeyi dönüştürmeye ekler.
ScaleTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen faktörlere göre ölçeklendirir.
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.
SetLineCap(LineCap, LineCap, DashCap)	Bu Pentarafından çizilen çizgileri sonlandırmak için kullanılan büyük harf stilini belirleyen değerleri ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
TranslateTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen boyutlara çevirir.
TranslateTransform(Single, Single)	Yerel geometrik dönüşümü belirtilen boyutlara çevirir. Bu yöntem, çeviriyi dönüştürmeye ekler.