Region Sınıf

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.5.26302.115

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 PaintEventArgs olay işleyicisinin bir parametresi olan ePaint gerektirir. Kod örneği, bir nesneden öğesinin başka bir DataRegionDataiçin nasıl ayarlandığını Data gösterirRegionData.

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: Kırpmayı Bölgeyle 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ölgeyle İsabet Testi Kullanma.

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

Note

.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

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

Yöntemler

Name	Description
Clone()	Bu Regiontam bir kopyasını oluşturur.
Complement(GraphicsPath)	Bunu Region , belirtilen GraphicsPath öğesinin bu ile Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(Rectangle)	Bunu Region , belirtilen Rectangle yapının bu ile Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(RectangleF)	Bunu Region , belirtilen RectangleF yapının bu ile Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Complement(Region)	Bunu Region , belirtilen Region öğesinin bu ile Regionkesişmeyen bölümünü içerecek şekilde güncelleştirir.
Dispose()	Bu Regiontarafından kullanılan tüm kaynakları serbest bırakır.
Equals(Region, Graphics)	Belirtilen çizim yüzeyinde belirtilenle Region aynı Region olup olmadığını sınar.
Exclude(GraphicsPath)	Bunu Region , iç kısmının yalnızca belirtilen GraphicsPathile kesişmeyen bölümünü içerecek şekilde güncelleştirir.
Exclude(Rectangle)	Bunu Region , iç kısmının yalnızca belirtilen Rectangle yapıyla kesişmeyen bölümünü içerecek şekilde güncelleştirir.
Exclude(RectangleF)	Bunu Region , iç kısmının yalnızca belirtilen RectangleF yapıyla kesişmeyen bölümünü içerecek şekilde güncelleştirir.
Exclude(Region)	Bunu Region , iç kısmının yalnızca belirtilen Regionile kesişmeyen bölümü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)	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 bir dikdörtgeni temsil eden bir Graphics yapı alır.
GetHrgn(Graphics)	Belirtilen grafik bağlamında buna Region bir Windows tanıtıcısı döndürür.
GetRegionData()	Bunu RegionDataaçıklayan bilgileri temsil eden bir Region döndürür.
GetRegionScans(Matrix)	Belirtilen matris dönüşümü uygulandıktan sonra buna RectangleF yakın olan bir yapı dizisi Region döndürür.
Intersect(GraphicsPath)	Bunu Region belirtilen GraphicsPathile kendi kesişimine güncelleştirir.
Intersect(Rectangle)	Bunu Region belirtilen Rectangle yapıyla kendi kesişimine güncelleştirir.
Intersect(RectangleF)	Bunu Region belirtilen RectangleF yapıyla kendi kesişimine güncelleştirir.
Intersect(Region)	Bunu Region belirtilen Regionile kendi kesişimine güncelleştirir.
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 nesne içinde bulunup bulunmadığını sınar Graphics .
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Belirtilen dikdörtgen kullanılarak çizildiğinde, belirtilen dikdörtgenin herhangi bir bölümünün bunun Region 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(Point, Graphics)	Belirtilen kullanılarak çizildiğinde belirtilen Point yapının bunun Region içinde bulunup bulunmadığını sınar Graphics.
IsVisible(Point)	Belirtilen Point yapının içinde Regionbulunup bulunmadığını sınar.
IsVisible(PointF, Graphics)	Belirtilen kullanılarak çizildiğinde belirtilen PointF yapının bunun Region içinde bulunup bulunmadığını sınar Graphics.
IsVisible(PointF)	Belirtilen PointF yapının içinde Regionbulunup bulunmadığını sınar.
IsVisible(Rectangle, Graphics)	Belirtilen yapı 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(Rectangle)	Belirtilen Rectangle yapının herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(RectangleF, Graphics)	Belirtilen yapı 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(RectangleF)	Belirtilen RectangleF yapının herhangi bir bölümünün bu Regioniçinde yer alıp almadığını sınar.
IsVisible(Single, Single, Graphics)	Belirtilen kullanılarak çizildiğinde belirtilen noktanın içinde Region bulunup bulunmadığını sınar Graphics.
IsVisible(Single, Single, Single, Single, Graphics)	Belirtilen dikdörtgen kullanılarak çizildiğinde, belirtilen dikdörtgenin herhangi bir bölümünün 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)	Belirtilen noktanın içinde Regionbulunup bulunmadığını sınar.
MakeEmpty()	Bunu Region boş bir iç mekana başlatır.
MakeInfinite()	Bu Region nesneyi sonsuz bir iç öğeye başlatır.
ReleaseHrgn(IntPtr)	tanıtıcısını Regionserbest bırakır.
Transform(Matrix)	Bunu Region belirtilen Matrixdeğerine dönüştürür.
Translate(Int32, Int32)	Bunun Region koordinatlarını belirtilen tutara göre kaydırıyor.
Translate(Single, Single)	Bunun Region koordinatlarını belirtilen tutara göre kaydırıyor.
Union(GraphicsPath)	Bunu Region kendi ve belirtilen GraphicsPathbirleşimiyle güncelleştirir.
Union(Rectangle)	Bu Region , kendisini ve belirtilen Rectangle yapısının birleşimine güncelleştirir.
Union(RectangleF)	Bu Region , kendisini ve belirtilen RectangleF yapısının birleşimine güncelleştirir.
Union(Region)	Bunu Region kendi ve belirtilen Regionbirleşimiyle güncelleştirir.
Xor(GraphicsPath)	Bunu Region , belirtilen GraphicsPathile kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(Rectangle)	Bunu Region , belirtilen Rectangle yapıyla kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(RectangleF)	Bunu Region , belirtilen RectangleF yapıyla kendi kesişimini çıkararak birleşime güncelleştirir.
Xor(Region)	Bunu Region , belirtilen Regionile kendi kesişimini çıkararak birleşime güncelleştirir.

Ayrıca bkz.

• Rectangle
• GraphicsPath
• Bölgeleri Kullanarak