Region 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-preview.5.24306.5

Kaynak:

Region.cs

Dikdörtgenlerden ve yollardan oluşan grafik şeklinin iç kısmını 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 Paint olay işleyicisinin bir parametresi olan PaintEventArgsegerektirir. Kod örneği, başka bir RegionDataiçin Data ayarlamak üzere bir RegionData nesnesinden Data nasıl kullanılacağını 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

Bölge, koordinatları dünya koordinatlarında belirtildiğinden ö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: Bölgekırpmayı kullanma .

Uygulama, bir noktanın mı yoksa dikdörtgenin mi bölgeyle kesişip kesişmediğini denetleme gibi isabet testi 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: Bölgeile İsabet Testlerini Kullanma .

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

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

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

Yöntemler

Clone()	Bu Regiontam bir kopyasını oluşturur.
Complement(GraphicsPath)	Bu Region belirtilen GraphicsPath bu Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(Rectangle)	Bu Region, belirtilen Rectangle yapısının bu Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(RectangleF)	Bu Region, belirtilen RectangleF yapısının bu Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(Region)	Bu Region belirtilen Region bu Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
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 Region belirtilen çizim yüzeyindeki bu Region aynı olup olmadığını sınar.
Exclude(GraphicsPath)	Bu Region yalnızca belirtilen GraphicsPathile kesişmeyen iç kısmını içerecek şekilde güncelleştirir.
Exclude(Rectangle)	Bu Region, iç kısmının yalnızca belirtilen Rectangle yapısıyla kesişmeyen bölümünü içerecek şekilde güncelleştirir.
Exclude(RectangleF)	Bu Region, iç kısmının yalnızca belirtilen RectangleF yapısıyla kesişmeyen bölümünü içerecek şekilde güncelleştirir.
Exclude(Region)	Bu Region yalnızca belirtilen Regionile kesişmeyen iç kısmını içerecek şekilde güncelleştirir.
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)	Bir tanıtıcıdan belirtilen mevcut GDI bölgesine yeni bir Region başlatır.
GetBounds(Graphics)	Bu Region bir Graphics nesnesinin çizim yüzeyinde sınırlayan bir dikdörtgeni temsil eden bir RectangleF yapısı alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetHrgn(Graphics)	Belirtilen grafik bağlamında bu Region bir Windows tanıtıcısı döndürür.
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)
GetRegionData()	Bu Regionaçıklayan bilgileri temsil eden bir RegionData döndürür.
GetRegionScans(Matrix)	Belirtilen matris dönüşümü uygulandıktan sonra bu Region yaklaşık olarak bu RectangleF yapılardan oluşan bir dizi döndürür.
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)
Intersect(GraphicsPath)	Bu Region belirtilen GraphicsPathile kendi kesişimine güncelleştirir.
Intersect(Rectangle)	Bu Region belirtilen Rectangle yapısıyla kendi kesişimine güncelleştirir.
Intersect(RectangleF)	Bu Region belirtilen RectangleF yapısıyla kendi kesişimine güncelleştirir.
Intersect(Region)	Bu Region belirtilen Regionile kendi kesişimine güncelleştirir.
IsEmpty(Graphics)	Bu Region belirtilen çizim yüzeyinde boş bir iç öğe olup olmadığını sınar.
IsInfinite(Graphics)	Bu Region belirtilen çizim yüzeyinde sonsuz bir iç öğeye sahip olup olmadığını sınar.
IsVisible(Int32, Int32, Graphics)	Belirtilen Graphics nesnesi kullanılarak çizildiğinde belirtilen noktanın bu Region nesnesi içinde bulunup bulunmadığını sınar.
IsVisible(Int32, Int32, Int32, Int32)	Belirtilen dikdörtgenin herhangi bir bölümünün bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Belirtilen dikdörtgenin herhangi bir bölümünün, belirtilen Graphicskullanılarak çizildiğinde bu Region içinde bulunup bulunmadığını sınar.
IsVisible(Point)	Belirtilen Point yapısının bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Point, Graphics)	Belirtilen Graphicskullanılarak çizildiğinde belirtilen Point yapısının bu Region içinde bulunup bulunmadığını sınar.
IsVisible(PointF)	Belirtilen PointF yapısının bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(PointF, Graphics)	Belirtilen Graphicskullanılarak çizildiğinde belirtilen PointF yapısının bu Region içinde bulunup bulunmadığını sınar.
IsVisible(Rectangle)	Belirtilen Rectangle yapısının herhangi bir bölümünün bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Rectangle, Graphics)	Belirtilen Graphicskullanılarak çizildiğinde, belirtilen Rectangle yapısının herhangi bir bölümünün bu Region içinde bulunup bulunmadığını sınar.
IsVisible(RectangleF)	Belirtilen RectangleF yapısının herhangi bir bölümünün bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(RectangleF, Graphics)	Belirtilen Graphicskullanılarak çizildiğinde, belirtilen RectangleF yapısının herhangi bir bölümünün bu Region içinde bulunup bulunmadığını sınar.
IsVisible(Single, Single)	Belirtilen noktanın bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Single, Single, Graphics)	Belirtilen Graphicskullanılarak çizildiğinde belirtilen noktanın bu Region içinde bulunup bulunmadığını sınar.
IsVisible(Single, Single, Single, Single)	Belirtilen dikdörtgenin herhangi bir bölümünün bu Regioniçinde bulunup bulunmadığını sınar.
IsVisible(Single, Single, Single, Single, Graphics)	Belirtilen dikdörtgenin herhangi bir bölümünün, belirtilen Graphicskullanılarak çizildiğinde bu Region içinde bulunup bulunmadığını sınar.
MakeEmpty()	Bu Region boş bir iç mekana başlatır.
MakeInfinite()	Bu Region nesnesini sonsuz bir iç mekana başlatır.
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)
ReleaseHrgn(IntPtr)	Regiontanıtıcısını serbest bırakır.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Transform(Matrix)	Bu Region belirtilen Matrixdönüştürür.
Translate(Int32, Int32)	Bu Region koordinatlarını belirtilen tutara göre kaydırıyor.
Translate(Single, Single)	Bu Region koordinatlarını belirtilen tutara göre kaydırıyor.
Union(GraphicsPath)	Bu Region kendisi ve belirtilen GraphicsPathbirleşimiyle güncelleştirir.
Union(Rectangle)	Bu Region kendisini ve belirtilen Rectangle yapısının birleşimiyle güncelleştirir.
Union(RectangleF)	Bu Region kendisini ve belirtilen RectangleF yapısının birleşimiyle güncelleştirir.
Union(Region)	Bu Region kendisi ve belirtilen Regionbirleşimiyle güncelleştirir.
Xor(GraphicsPath)	Bu Region belirtilen GraphicsPathile kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(Rectangle)	Bu Region belirtilen Rectangle yapısıyla kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(RectangleF)	Bu Region belirtilen RectangleF yapısıyla kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(Region)	Bu Region belirtilen Regionile kendi kesişimini çıkararak birleşime güncelleştirir.

Ayrıca bkz.

• Rectangle
• GraphicsPath
• Bölgeleri Kullanarak