Region Kelas

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

Region.cs

Menjelaskan interior bentuk grafis yang terdiri dari persegi panjang dan jalur. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Region

Penerapan

IDisposable

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Formulir Windows, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan Paint aktivitas. Contoh kode menunjukkan cara menggunakan Data dari satu RegionData objek untuk mengatur Data untuk objek lain RegionData.

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

Keterangan

Wilayah dapat diskalakan karena koordinatnya ditentukan dalam koordinat dunia. Namun, pada permukaan gambar, interiornya tergantung pada ukuran dan bentuk piksel yang mewakilinya. Aplikasi dapat menggunakan wilayah untuk mengklip output operasi gambar. Wilayah ini disebut wilayah kliping. Untuk informasi selengkapnya tentang menggunakan wilayah untuk kliping, lihat Cara: Menggunakan Kliping dengan Wilayah.

Aplikasi juga dapat menggunakan wilayah dalam operasi pengujian temuan, seperti memeriksa apakah titik atau persegi panjang bersinggungan dengan suatu wilayah. Untuk informasi selengkapnya tentang menggunakan wilayah untuk pengujian hit, lihat Cara: Menggunakan Pengujian Hit dengan Wilayah.

Aplikasi dapat mengisi wilayah dengan menggunakan Graphics.FillRegion metode dan Brush objek .

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Konstruktor

Region()	Menginisialisasi baru Region.
Region(GraphicsPath)	Menginisialisasi baru Region dengan yang ditentukan GraphicsPath.
Region(Rectangle)	Menginisialisasi baru Region dari struktur yang ditentukan Rectangle .
Region(RectangleF)	Menginisialisasi baru Region dari struktur yang ditentukan RectangleF .
Region(RegionData)	Menginisialisasi baru Region dari data yang ditentukan.

Metode

Clone()	Membuat salinan yang tepat dari ini Region.
Complement(GraphicsPath)	Updates ini Region untuk berisi bagian dari yang ditentukan GraphicsPath yang tidak bersinggungan dengan iniRegion.
Complement(Rectangle)	Updates ini Region untuk berisi bagian dari struktur yang ditentukan Rectangle yang tidak bersinggungan dengan iniRegion.
Complement(RectangleF)	Updates ini Region untuk berisi bagian dari struktur yang ditentukan RectangleF yang tidak bersinggungan dengan iniRegion.
Complement(Region)	Updates ini Region untuk berisi bagian dari yang ditentukan Region yang tidak bersinggungan dengan iniRegion.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang digunakan oleh ini Region.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Equals(Region, Graphics)	Menguji apakah yang ditentukan Region identik dengan ini Region pada permukaan gambar yang ditentukan.
Exclude(GraphicsPath)	Updates ini Region hanya berisi bagian interiornya yang tidak bersinggungan dengan yang ditentukanGraphicsPath.
Exclude(Rectangle)	Updates ini Region hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur yang ditentukanRectangle.
Exclude(RectangleF)	Updates ini Region hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur yang ditentukanRectangleF.
Exclude(Region)	Updates ini Region hanya berisi bagian interiornya yang tidak bersinggungan dengan yang ditentukanRegion.
Finalize()	Memungkinkan objek untuk mencoba membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum direklamasi kembali oleh pengumpulan sampah.
FromHrgn(IntPtr)	Menginisialisasi baru Region dari handel ke wilayah GDI yang ada yang ditentukan.
GetBounds(Graphics)	RectangleF Mendapatkan struktur yang mewakili persegi panjang yang mengikat ini Region pada permukaan Graphics gambar objek.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHrgn(Graphics)	Mengembalikan handel Windows ke ini Region dalam konteks grafik yang ditentukan.
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetRegionData()	Mengembalikan RegionData yang mewakili informasi yang menjelaskan ini Region.
GetRegionScans(Matrix)	Mengembalikan array RectangleF struktur yang memperkirakan ini Region setelah transformasi matriks yang ditentukan diterapkan.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Intersect(GraphicsPath)	Updates ini Region ke persimpangan dirinya sendiri dengan yang ditentukan GraphicsPath.
Intersect(Rectangle)	Updates ini Region ke persimpangan dirinya sendiri dengan struktur yang ditentukanRectangle.
Intersect(RectangleF)	Updates ini Region ke persimpangan dirinya sendiri dengan struktur yang ditentukanRectangleF.
Intersect(Region)	Updates ini Region ke persimpangan dirinya sendiri dengan yang ditentukan Region.
IsEmpty(Graphics)	Menguji apakah ini Region memiliki interior kosong pada permukaan gambar yang ditentukan.
IsInfinite(Graphics)	Menguji apakah ini Region memiliki interior tak terbatas pada permukaan gambar yang ditentukan.
IsVisible(Int32, Int32, Graphics)	Menguji apakah titik yang ditentukan terkandung dalam objek ini Region saat digambar menggunakan objek yang ditentukan Graphics .
IsVisible(Int32, Int32, Int32, Int32)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam ini Region.
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
IsVisible(Point)	Menguji apakah struktur yang ditentukan terkandung Point dalam ini Region.
IsVisible(Point, Graphics)	Menguji apakah struktur yang ditentukan terkandung Point dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
IsVisible(PointF)	Menguji apakah struktur yang ditentukan terkandung PointF dalam ini Region.
IsVisible(PointF, Graphics)	Menguji apakah struktur yang ditentukan terkandung PointF dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
IsVisible(Rectangle)	Menguji apakah ada bagian dari struktur yang ditentukan yang terkandung Rectangle dalam ini Region.
IsVisible(Rectangle, Graphics)	Menguji apakah ada bagian dari struktur yang ditentukan yang terkandung Rectangle dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
IsVisible(RectangleF)	Menguji apakah ada bagian dari struktur yang ditentukan yang terkandung RectangleF dalam ini Region.
IsVisible(RectangleF, Graphics)	Menguji apakah ada bagian dari struktur yang ditentukan yang terkandung RectangleF dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
IsVisible(Single, Single)	Menguji apakah titik yang ditentukan terkandung dalam ini Region.
IsVisible(Single, Single, Graphics)	Menguji apakah titik yang ditentukan terkandung dalam ini Region saat digambar menggunakan Graphics.
IsVisible(Single, Single, Single, Single)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam ini Region.
IsVisible(Single, Single, Single, Single, Graphics)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam ini Region saat digambar menggunakan yang ditentukan Graphics.
MakeEmpty()	Menginisialisasi ini Region ke interior kosong.
MakeInfinite()	Menginisialisasi objek ini Region ke interior tak terbatas.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ReleaseHrgn(IntPtr)	Merilis handel dari Region.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Transform(Matrix)	Mentransformasi ini Region dengan yang ditentukan Matrix.
Translate(Int32, Int32)	Mengimbangi koordinat ini Region dengan jumlah yang ditentukan.
Translate(Single, Single)	Mengimbangi koordinat ini Region dengan jumlah yang ditentukan.
Union(GraphicsPath)	Updates ini Region untuk persatuan dirinya sendiri dan yang ditentukanGraphicsPath.
Union(Rectangle)	Updates ini Region untuk persatuan dirinya sendiri dan struktur yang ditentukanRectangle.
Union(RectangleF)	Updates ini Region untuk persatuan dirinya sendiri dan struktur yang ditentukanRectangleF.
Union(Region)	Updates ini Region untuk persatuan dirinya sendiri dan yang ditentukanRegion.
Xor(GraphicsPath)	Updates ini Region ke serikat dikurangi persimpangan dirinya dengan yang ditentukan GraphicsPath.
Xor(Rectangle)	Updates ini Region ke serikat dikurangi persimpangan dirinya dengan struktur yang ditentukanRectangle.
Xor(RectangleF)	Updates ini Region ke serikat dikurangi persimpangan dirinya dengan struktur yang ditentukanRectangleF.
Xor(Region)	Updates ini Region ke serikat dikurangi persimpangan dirinya dengan yang ditentukan Region.

Lihat juga

• Rectangle
• GraphicsPath
• Menggunakan Wilayah