Region Kelas

Referensi

Definisi

Ruang nama:: System.Drawing

Rakitan:: System.Drawing.Common.dll

Rakitan:: System.Drawing.dll

Paket:: System.Drawing.Common v8.0.6

Paket:: System.Drawing.Common v9.0.0-preview.5.24306.5

Sumber:: Region.cs

Sumber:: Region.cs

Sumber:: Region.cs

Sumber:: Region.cs

Sumber:: Region.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

[System.Runtime.InteropServices.ComVisible(false)]
public sealed class Region : MarshalByRefObject, IDisposable

type Region = class
    inherit MarshalByRefObject
    interface IDisposable

[<System.Runtime.InteropServices.ComVisible(false)>]
type Region = class
    inherit MarshalByRefObject
    interface IDisposable

Public NotInheritable Class Region
Inherits MarshalByRefObject
Implements IDisposable

Warisan: Object

MarshalByRefObject
Region

Atribut: ComVisibleAttribute

Penerapan: IDisposable

Contoh

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

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 menggambar. 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 metode Graphics.FillRegion dan objek Brush.

Nota

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 Regionbaru.
Region(GraphicsPath)	Menginisialisasi Region baru dengan GraphicsPathyang ditentukan .
Region(Rectangle)	Menginisialisasi Region baru dari struktur Rectangle yang ditentukan.
Region(RectangleF)	Menginisialisasi Region baru dari struktur RectangleF yang ditentukan.
Region(RegionData)	Menginisialisasi Region baru dari data yang ditentukan.

Metode

Clone()	Membuat salinan yang tepat dari Regionini.
Complement(GraphicsPath)	Perbarui Region ini untuk berisi bagian dari GraphicsPath yang ditentukan yang tidak bersinggungan dengan Regionini.
Complement(Rectangle)	Perbarui Region ini untuk berisi bagian dari struktur Rectangle yang ditentukan yang tidak bersinggungan dengan Regionini.
Complement(RectangleF)	Perbarui Region ini untuk berisi bagian dari struktur RectangleF yang ditentukan yang tidak bersinggungan dengan Regionini.
Complement(Region)	Perbarui Region ini untuk berisi bagian dari Region yang ditentukan yang tidak bersinggungan dengan Regionini.
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 Regionini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Equals(Region, Graphics)	Menguji apakah Region yang ditentukan identik dengan Region ini pada permukaan gambar yang ditentukan.
Exclude(GraphicsPath)	Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan GraphicsPathyang ditentukan.
Exclude(Rectangle)	Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur Rectangle yang ditentukan.
Exclude(RectangleF)	Perbarui Region ini agar hanya berisi bagian interiornya yang tidak bersinggungan dengan struktur RectangleF yang ditentukan.
Exclude(Region)	Perbarui Region ini hanya berisi bagian interiornya yang tidak bersinggungan dengan Regionyang ditentukan.
Finalize()	Memungkinkan objek untuk mencoba membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum direklamasi kembali oleh pengumpulan sampah.
FromHrgn(IntPtr)	Menginisialisasi Region baru dari handel ke wilayah GDI yang ada yang ditentukan.
GetBounds(Graphics)	Mendapatkan struktur RectangleF yang mewakili persegi panjang yang mengikat Region ini pada permukaan gambar objek Graphics.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHrgn(Graphics)	Mengembalikan handel Windows ke Region ini dalam konteks grafik yang ditentukan.
GetLifetimeService()	Kedaluwarsa. 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 Regionini.
GetRegionScans(Matrix)	Mengembalikan array struktur RectangleF yang memperkirakan Region ini setelah transformasi matriks yang ditentukan diterapkan.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Kedaluwarsa. Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Intersect(GraphicsPath)	Perbarui Region ini ke persimpangan dirinya sendiri dengan GraphicsPathyang ditentukan .
Intersect(Rectangle)	Perbarui Region ini ke persimpangan dirinya sendiri dengan struktur Rectangle yang ditentukan.
Intersect(RectangleF)	Perbarui Region ini ke persimpangan dirinya sendiri dengan struktur RectangleF yang ditentukan.
Intersect(Region)	Perbarui Region ini ke persimpangan dirinya sendiri dengan Regionyang ditentukan .
IsEmpty(Graphics)	Menguji apakah Region ini memiliki interior kosong pada permukaan gambar yang ditentukan.
IsInfinite(Graphics)	Menguji apakah Region ini memiliki interior tak terbatas pada permukaan gambar yang ditentukan.
IsVisible(Int32, Int32, Graphics)	Menguji apakah titik yang ditentukan terkandung dalam objek Region ini saat digambar menggunakan objek Graphics yang ditentukan.
IsVisible(Int32, Int32, Int32, Int32)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam Regionini .
IsVisible(Int32, Int32, Int32, Int32, Graphics)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(Point)	Menguji apakah struktur Point yang ditentukan terkandung dalam Regionini.
IsVisible(Point, Graphics)	Menguji apakah struktur Point yang ditentukan terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(PointF)	Menguji apakah struktur PointF yang ditentukan terkandung dalam Regionini.
IsVisible(PointF, Graphics)	Menguji apakah struktur PointF yang ditentukan terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(Rectangle)	Menguji apakah ada bagian dari struktur Rectangle yang ditentukan yang terkandung dalam Regionini.
IsVisible(Rectangle, Graphics)	Menguji apakah ada bagian dari struktur Rectangle yang ditentukan yang terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(RectangleF)	Menguji apakah ada bagian dari struktur RectangleF yang ditentukan yang terkandung dalam Regionini.
IsVisible(RectangleF, Graphics)	Menguji apakah ada bagian dari struktur RectangleF yang ditentukan yang terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(Single, Single)	Menguji apakah titik yang ditentukan terkandung dalam Regionini .
IsVisible(Single, Single, Graphics)	Menguji apakah titik yang ditentukan terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
IsVisible(Single, Single, Single, Single)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam Regionini .
IsVisible(Single, Single, Single, Single, Graphics)	Menguji apakah ada bagian dari persegi panjang yang ditentukan yang terkandung dalam Region ini saat digambar menggunakan Graphicsyang ditentukan .
MakeEmpty()	Menginisialisasi Region ini ke interior kosong.
MakeInfinite()	Menginisialisasi objek Region ini ke interior tak terbatas.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek MarshalByRefObject saat ini. (Diperoleh dari MarshalByRefObject)
ReleaseHrgn(IntPtr)	Merilis handel Region.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Transform(Matrix)	Mengubah Region ini oleh Matrixyang ditentukan.
Translate(Int32, Int32)	Mengimbangi koordinat Region ini dengan jumlah yang ditentukan.
Translate(Single, Single)	Mengimbangi koordinat Region ini dengan jumlah yang ditentukan.
Union(GraphicsPath)	Perbarui Region ini ke gabungan dirinya sendiri dan GraphicsPathyang ditentukan .
Union(Rectangle)	Memperbarui Region ini ke gabungan dirinya sendiri dan struktur Rectangle yang ditentukan.
Union(RectangleF)	Memperbarui Region ini ke gabungan dirinya sendiri dan struktur RectangleF yang ditentukan.
Union(Region)	Perbarui Region ini ke gabungan dirinya sendiri dan Regionyang ditentukan .
Xor(GraphicsPath)	Perbarui Region ini ke serikat dikurangi persimpangan dirinya dengan GraphicsPathyang ditentukan .
Xor(Rectangle)	Perbarui Region ini ke serikat dikurangi persimpangan dirinya dengan struktur Rectangle yang ditentukan.
Xor(RectangleF)	Perbarui Region ini ke serikat dikurangi persimpangan dirinya dengan struktur RectangleF yang ditentukan.
Xor(Region)	Perbarui Region ini ke serikat dikurangi persimpangan dirinya dengan Regionyang ditentukan .

Berlaku untuk

Bagikan melalui