Graphics.ExcludeClip Metode

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Memperbarui wilayah klip Graphics ini untuk mengecualikan area yang ditentukan oleh struktur Rectangle.

Overload

ExcludeClip(Region)	Memperbarui wilayah klip Graphics ini untuk mengecualikan area yang ditentukan oleh Region.
ExcludeClip(Rectangle)	Memperbarui wilayah klip Graphics ini untuk mengecualikan area yang ditentukan oleh struktur Rectangle.

ExcludeClip(Region)

Memperbarui wilayah klip Graphics ini untuk mengecualikan area yang ditentukan oleh Region.

public:
 void ExcludeClip(System::Drawing::Region ^ region);

public void ExcludeClip (System.Drawing.Region region);

member this.ExcludeClip : System.Drawing.Region -> unit

Public Sub ExcludeClip (region As Region)

Parameter

region

Region

Region yang menentukan wilayah yang akan dikecualikan dari wilayah klip.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

• Membuat persegi panjang 100 piksel dengan 100 piksel yang sudut kiri atasnya berada di koordinat (100, 100).

• Mengatur wilayah kliping untuk mengecualikan persegi panjang.

• Mengisi persegi panjang 300 piksel dengan 300 piksel yang sudut kiri atasnya berada di koordinat (0, 0) dengan kuas biru solid.

Hasilnya adalah persegi panjang biru dengan area persegi menuju sudut kanan bawahnya yang hilang.

public:
   void ExcludeClipRegion( PaintEventArgs^ e )
   {
      // Create rectangle for region.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Create region for exclusion.
      System::Drawing::Region^ excludeRegion = gcnew System::Drawing::Region( excludeRect );

      // Set clipping region to exclude region.
      e->Graphics->ExcludeClip( excludeRegion );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRegion(PaintEventArgs e)
{
             
    // Create rectangle for region.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Create region for exclusion.
    Region excludeRegion = new Region(excludeRect);
             
    // Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRegion(ByVal e As PaintEventArgs)

    ' Create rectangle for region.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Create region for exclusion.
    Dim excludeRegion As New [Region](excludeRect)

    ' Set clipping region to exclude region.
    e.Graphics.ExcludeClip(excludeRegion)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Keterangan

Metode ini mengecualikan area yang ditentukan oleh parameter region dari wilayah klip saat ini dan menetapkan area yang dihasilkan ke properti Clip dari Graphicsini.

ExcludeClip(Rectangle)

Memperbarui wilayah klip Graphics ini untuk mengecualikan area yang ditentukan oleh struktur Rectangle.

public:
 void ExcludeClip(System::Drawing::Rectangle rect);

public void ExcludeClip (System.Drawing.Rectangle rect);

member this.ExcludeClip : System.Drawing.Rectangle -> unit

Public Sub ExcludeClip (rect As Rectangle)

Parameter

rect

Rectangle

Rectangle struktur yang menentukan persegi panjang untuk dikecualikan dari wilayah klip.

Contoh

Contoh kode berikut dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgse, yang merupakan parameter penanganan aktivitas Paint. Kode melakukan tindakan berikut:

• Membuat persegi panjang 100 piksel dengan 100 piksel yang sudut kiri atasnya berada di koordinat (100, 100).

• Membuat wilayah yang ditentukan oleh persegi panjang.

• Mengatur wilayah kliping untuk mengecualikan wilayah persegi panjang.

• Mengisi persegi panjang 300 piksel dengan 300 piksel yang sudut kiri atasnya berada di koordinat (0, 0) dengan kuas biru solid.

Hasilnya adalah persegi panjang biru dengan wilayah persegi menuju sudut kanan bawahnya yang hilang.

public:
   void ExcludeClipRectangle( PaintEventArgs^ e )
   {
      // Create rectangle for exclusion.
      Rectangle excludeRect = Rectangle(100,100,200,200);

      // Set clipping region to exclude rectangle.
      e->Graphics->ExcludeClip( excludeRect );

      // Fill large rectangle to show clipping region.
      e->Graphics->FillRectangle( gcnew SolidBrush( Color::Blue ), 0, 0, 300, 300 );
   }

public void ExcludeClipRectangle(PaintEventArgs e)
{
             
    // Create rectangle for exclusion.
    Rectangle excludeRect = new Rectangle(100, 100, 200, 200);
             
    // Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect);
             
    // Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Blue), 0, 0, 300, 300);
}

Public Sub ExcludeClipRectangle(ByVal e As PaintEventArgs)

    ' Create rectangle for exclusion.
    Dim excludeRect As New Rectangle(100, 100, 200, 200)

    ' Set clipping region to exclude rectangle.
    e.Graphics.ExcludeClip(excludeRect)

    ' Fill large rectangle to show clipping region.
    e.Graphics.FillRectangle(New SolidBrush(Color.Blue), 0, 0, _
    300, 300)
End Sub

Keterangan

Metode ini mengecualikan area yang ditentukan oleh parameter rect dari wilayah klip saat ini dan menetapkan area yang dihasilkan ke properti Clip dari Graphicsini.