Graphics.ExcludeClip Metoda

Definicja

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
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

Aktualizuje region klipu tego Graphics, aby wykluczyć obszar określony przez Region.

C#
public void ExcludeClip(System.Drawing.Region 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.

C#
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);
}

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.

Dotyczy

.NET 10 (package-provided) i inne wersje
Produkt Wersje
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

ExcludeClip(Rectangle)

Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs
Źródło:
Graphics.cs

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

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

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.

C#
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);
}

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.

Dotyczy

.NET 10 (package-provided) i inne wersje
Produkt Wersje
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10