Region 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:

Region.cs

Dikdörtgenlerden ve yollardan oluşan grafik şeklinin içini açıklar. Bu sınıf devralınamaz.

public ref class Region sealed : MarshalByRefObject, IDisposable

public sealed class Region : MarshalByRefObject, IDisposable

type Region = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable

Devralma

Object

MarshalByRefObject

Region

Uygulamalar

IDisposable

Örnekler

Aşağıdaki kod örneği, Windows Forms ile kullanılmak üzere tasarlanmıştır ve olay işleyicisinin Paint bir parametresi olan gerektirir.PaintEventArgse Kod örneği, bir nesneden öğesinin Data başka bir RegionDataRegionDataiçin nasıl ayarlandığını Data gösterir.

private:
   void DemonstrateRegionData2( PaintEventArgs^ e )
   {
      //Create a simple region.
      System::Drawing::Region^ region1 = gcnew System::Drawing::Region( Rectangle(10,10,100,100) );

      // Extract the region data.
      System::Drawing::Drawing2D::RegionData^ region1Data = region1->GetRegionData();
      array<Byte>^data1;
      data1 = region1Data->Data;

      // Create a second region.
      System::Drawing::Region^ region2 = gcnew System::Drawing::Region;

      // Get the region data for the second region.
      System::Drawing::Drawing2D::RegionData^ region2Data = region2->GetRegionData();

      // Set the Data property for the second region to the Data from the first region.
      region2Data->Data = data1;

      // Construct a third region using the modified RegionData of the second region.
      System::Drawing::Region^ region3 = gcnew System::Drawing::Region( region2Data );

      // Dispose of the first and second regions.
      delete region1;
      delete region2;

      // Call ExcludeClip passing in the third region.
      e->Graphics->ExcludeClip( region3 );

      // Fill in the client rectangle.
      e->Graphics->FillRectangle( Brushes::Red, this->ClientRectangle );
      delete region3;
   }

private void DemonstrateRegionData2(PaintEventArgs e)
{

    //Create a simple region.
    Region region1 = new Region(new Rectangle(10, 10, 100, 100));

    // Extract the region data.
    System.Drawing.Drawing2D.RegionData region1Data = region1.GetRegionData();
    byte[] data1;
    data1 = region1Data.Data;

    // Create a second region.
    Region region2 = new Region();

    // Get the region data for the second region.
    System.Drawing.Drawing2D.RegionData region2Data = region2.GetRegionData();

    // Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1;

    // Construct a third region using the modified RegionData of the second region.
    Region region3 = new Region(region2Data);

    // Dispose of the first and second regions.
    region1.Dispose();
    region2.Dispose();

    // Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3);

    // Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, this.ClientRectangle);

    region3.Dispose();
}

Private Sub DemonstrateRegionData2(ByVal e As PaintEventArgs)

    'Create a simple region.
    Dim region1 As New Region(New Rectangle(10, 10, 100, 100))

    ' Extract the region data.
    Dim region1Data As System.Drawing.Drawing2D.RegionData = region1.GetRegionData
    Dim data1() As Byte
    data1 = region1Data.Data

    ' Create a second region.
    Dim region2 As New Region

    ' Get the region data for the second region.
    Dim region2Data As System.Drawing.Drawing2D.RegionData = region2.GetRegionData()

    ' Set the Data property for the second region to the Data from the first region.
    region2Data.Data = data1

    ' Construct a third region using the modified RegionData of the second region.
    Dim region3 As New Region(region2Data)

    ' Dispose of the first and second regions.
    region1.Dispose()
    region2.Dispose()

    ' Call ExcludeClip passing in the third region.
    e.Graphics.ExcludeClip(region3)

    ' Fill in the client rectangle.
    e.Graphics.FillRectangle(Brushes.Red, Me.ClientRectangle)

    region3.Dispose()

End Sub

Açıklamalar

Koordinatları dünya koordinatlarında belirtildiğinden bölge ölçeklenebilir. Ancak bir çizim yüzeyinde, iç kısmı onu temsil eden piksellerin boyutuna ve şekline bağlıdır. Bir uygulama, çizim işlemlerinin çıkışını kırpmak için bölgeleri kullanabilir. Bu bölgeler kırpma bölgeleri olarak adlandırılır. Kırpma için bölgeleri kullanma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Kırpmayı Bölgeyle Kullanma.

Uygulama, bir noktanın veya dikdörtgenin bir bölgeyle kesişip kesişmediğini denetleme gibi isabet sınama işlemlerinde bölgeleri de kullanabilir. İsabet testi için bölgeleri kullanma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Bir Bölgeyle İsabet Testi Kullanma.

Uygulama, yöntemini ve nesnesini kullanarak Graphics.FillRegion bir Brush bölgeyi doldurabilir.

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

Region()	Yeni Regionbir başlatır.
Region(GraphicsPath)	Belirtilen GraphicsPathile yeni Region bir başlatır.
Region(Rectangle)	Belirtilen Rectangle yapıdan yeni Region bir başlatır.
Region(RectangleF)	Belirtilen RectangleF yapıdan yeni Region bir başlatır.
Region(RegionData)	Belirtilen verilerden yeni Region bir başlatır.

Yöntemler

Clone()	Bu Regionöğesinin tam bir kopyasını oluşturur.
Complement(GraphicsPath)	BunuRegion, belirtilen GraphicsPath öğesinin bu ile kesişmeyen bölümünü içerecek şekilde GüncelleştirmelerRegion.
Complement(Rectangle)	BunuRegion, belirtilen Rectangle yapının bu ile kesişmeyen bölümünü içerecek şekilde GüncelleştirmelerRegion.
Complement(RectangleF)	BunuRegion, belirtilen RectangleF yapının bu ile kesişmeyen bölümünü içerecek şekilde GüncelleştirmelerRegion.
Complement(Region)	BunuRegion, belirtilen Region öğesinin bu ile kesişmeyen bölümünü içerecek şekilde GüncelleştirmelerRegion.
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 Regiontarafı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)
Equals(Region, Graphics)	Belirtilen çizim yüzeyinde belirtilen Region ile aynı Region olup olmadığını sınar.
Exclude(GraphicsPath)	BunuRegion, iç kısmının belirtilen GraphicsPathile kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.
Exclude(Rectangle)	BunuRegion, iç kısmının belirtilen Rectangle yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.
Exclude(RectangleF)	BunuRegion, iç kısmının belirtilen RectangleF yapıyla kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.
Exclude(Region)	BunuRegion, iç kısmının belirtilen Regionile kesişmeyen kısmını içerecek şekilde Güncelleştirmeler.
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.
FromHrgn(IntPtr)	Belirtilen mevcut GDI bölgesine bir tanıtıcıdan yeni Region bir başlatır.
GetBounds(Graphics)	Bunu bir RectangleF nesnenin çizim yüzeyine sınırlayan Region dikdörtgeni temsil eden bir Graphics yapı alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetHrgn(Graphics)	Belirtilen grafik bağlamında buna Region bir Windows tanıtıcısı döndürür.
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)
GetRegionData()	Bunu Regionaçıklayan bilgileri temsil eden bir RegionData döndürür.
GetRegionScans(Matrix)	Belirtilen matris dönüşümü uygulandıktan sonra buna Region yakın bir yapı dizisi RectangleF döndürür.
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)
Intersect(GraphicsPath)	Bunu Region belirtilen GraphicsPathile kendi kesişimine Güncelleştirmeler.
Intersect(Rectangle)	Bunu Region belirtilen Rectangle yapıyla kendi kesişimine Güncelleştirmeler.
Intersect(RectangleF)	Bunu Region belirtilen RectangleF yapıyla kendi kesişimine Güncelleştirmeler.
Intersect(Region)	Bunu Region belirtilen Regionile kendi kesişimine Güncelleştirmeler.
IsEmpty(Graphics)	Bunun Region belirtilen çizim yüzeyinde boş bir iç öğe olup olmadığını sınar.
IsInfinite(Graphics)	Bunun Region belirtilen çizim yüzeyinde sonsuz bir iç öğeye sahip olup olmadığını sınar.
IsVisible(Int32, Int32, Graphics)	Belirtilen nesne kullanılarak çizildiğinde belirtilen noktanın bu Region nesnenin içinde bulunup bulunmadığını sınar Graphics .
IsVisible(Int32, Int32, Int32, Int32)	Belirtilen dikdörtgenin herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Belirtilen dikdörtgen kullanılarak çizildiğinde, belirtilen dikdörtgenin herhangi bir bölümünün bu Region içinde yer alıp almadığını sınar Graphics.
IsVisible(Point)	Belirtilen Point yapının bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Point, Graphics)	Belirtilen kullanılarak çizildiğinde belirtilen Point yapının içinde Region bulunup bulunmadığını sınar Graphics.
IsVisible(PointF)	Belirtilen PointF yapının bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(PointF, Graphics)	Belirtilen kullanılarak çizildiğinde belirtilen PointF yapının içinde Region bulunup bulunmadığını sınar Graphics.
IsVisible(Rectangle)	Belirtilen Rectangle yapının herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(Rectangle, Graphics)	Belirtilen kullanılarak çizildiğinde, belirtilen Rectangle yapının herhangi bir bölümünün bunun Region içinde bulunup bulunmadığını sınar Graphics.
IsVisible(RectangleF)	Belirtilen RectangleF yapının herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(RectangleF, Graphics)	Belirtilen kullanılarak çizildiğinde, belirtilen RectangleF yapının herhangi bir bölümünün bunun Region içinde bulunup bulunmadığını sınar Graphics.
IsVisible(Single, Single)	Belirtilen noktanın bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Single, Single, Graphics)	Belirtilen noktanın, belirtilen kullanılarak çizildiğinde bunun Region içinde bulunup bulunmadığını sınar Graphics.
IsVisible(Single, Single, Single, Single)	Belirtilen dikdörtgenin herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(Single, Single, Single, Single, Graphics)	Belirtilen dikdörtgen kullanılarak çizildiğinde, belirtilen dikdörtgenin herhangi bir bölümünün bu Region içinde yer alıp almadığını sınar Graphics.
MakeEmpty()	Bunu Region boş bir iç öğeye başlatır.
MakeInfinite()	Bu Region nesneyi sonsuz bir iç öğeye başlatır.
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)
ReleaseHrgn(IntPtr)	tanıtıcısını Regionserbest bırakır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Transform(Matrix)	Bunu Region belirtilen Matrixdeğerine dönüştürür.
Translate(Int32, Int32)	Bunun Region koordinatlarını belirtilen miktara göre kaydırıyor.
Translate(Single, Single)	Bunun Region koordinatlarını belirtilen miktara göre kaydırıyor.
Union(GraphicsPath)	Bunu Region kendi ve belirtilen GraphicsPathbirleşimiyle Güncelleştirmeler.
Union(Rectangle)	Bunu Region kendi ve belirtilen Rectangle yapının birleşimine Güncelleştirmeler.
Union(RectangleF)	Bunu Region kendi ve belirtilen RectangleF yapının birleşimine Güncelleştirmeler.
Union(Region)	Bunu Region kendi ve belirtilen Regionbirleşimiyle Güncelleştirmeler.
Xor(GraphicsPath)	BunuRegion, belirtilen GraphicsPathile kendi kesişimini çıkararak birleşime Güncelleştirmeler.
Xor(Rectangle)	Bunu Region birleşime Güncelleştirmeler, belirtilen Rectangle yapıyla kendi kesişimini çıkar.
Xor(RectangleF)	Bunu Region birleşime Güncelleştirmeler, belirtilen RectangleF yapıyla kendi kesişimini çıkar.
Xor(Region)	BunuRegion, belirtilen Regionile kendi kesişimini çıkararak birleşime Güncelleştirmeler.

Ayrıca bkz.

• Rectangle
• GraphicsPath
• Bölgeleri Kullanma