Graphics.ExcludeClip Metoda

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v9.0.0-rc.2.24474.1

Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez strukturę Rectangle.

Przeciążenia

ExcludeClip(Region)	Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez Region.
ExcludeClip(Rectangle)	Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez strukturę Rectangle.

ExcludeClip(Region)

Źródło:

Graphics.cs

Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez 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)

Parametry

region

Region

Region, który określa region do wykluczenia z regionu klipu.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

• Tworzy prostokąt o rozmiarze 100 pikseli o rozmiarze 100 pikseli, którego lewy górny róg znajduje się na współrzędnych (100, 100).

• Ustawia region wycinków, aby wykluczyć prostokąt.

• Wypełnia prostokąt o rozmiarze 300 pikseli o rozmiarze 300 pikseli, którego lewy górny róg znajduje się na współrzędnych (0, 0) z niebieskim pędzlem.

Wynikiem jest niebieski prostokąt z obszarem kwadratowym w kierunku brakującego dolnego rogu.

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

Uwagi

Ta metoda wyklucza obszar określony przez parametr region z bieżącego regionu klipu i przypisuje obszar wynikowy do właściwości Clip tego Graphics.

ExcludeClip(Rectangle)

Źródło:

Graphics.cs

Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez 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)

Parametry

rect

Rectangle

Rectangle struktura określająca prostokąt do wykluczenia z regionu klipu.

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse, który jest parametrem programu obsługi zdarzeń Paint. Kod wykonuje następujące akcje:

• Tworzy prostokąt o rozmiarze 100 pikseli o rozmiarze 100 pikseli, którego lewy górny róg znajduje się na współrzędnych (100, 100).

• Tworzy region zdefiniowany przez prostokąt.

• Ustawia region wycinków, aby wykluczyć prostokątny region.

• Wypełnia prostokąt o rozmiarze 300 pikseli o rozmiarze 300 pikseli, którego lewy górny róg znajduje się na współrzędnych (0, 0) z niebieskim pędzlem.

Wynik jest niebieskim prostokątem z obszarem kwadratowym w kierunku brakującego dolnego rogu.

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

Uwagi

Ta metoda wyklucza obszar określony przez parametr rect z bieżącego regionu klipu i przypisuje obszar wynikowy do właściwości Clip tego Graphics.