Graphics.SetClip Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.6.24327.6

Legt den Beschneidungsbereich dieses Graphics auf die Clip-Eigenschaft der angegebenen Graphicsfest.

Überlädt

SetClip(Region, CombineMode)	Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und die angegebene Regionkombiniert.
SetClip(RectangleF, CombineMode)	Legt den Beschneidungsbereich dieses Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und das durch eine RectangleF Struktur angegebene Rechteck kombiniert.
SetClip(Rectangle, CombineMode)	Legt den Beschneidungsbereich dieses Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und das durch eine Rectangle Struktur angegebene Rechteck kombiniert.
SetClip(Graphics, CombineMode)	Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Kombinationsvorgangs des aktuellen Clipbereichs und der Clip-Eigenschaft der angegebenen Graphicsfest.
SetClip(GraphicsPath, CombineMode)	Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und die angegebene GraphicsPathkombiniert.
SetClip(RectangleF)	Legt den Beschneidungsbereich dieses Graphics auf das durch eine RectangleF Struktur angegebene Rechteck fest.
SetClip(Rectangle)	Legt den Beschneidungsbereich dieses Graphics auf das durch eine Rectangle Struktur angegebene Rechteck fest.
SetClip(Graphics)	Legt den Beschneidungsbereich dieses Graphics auf die Clip-Eigenschaft der angegebenen Graphicsfest.
SetClip(GraphicsPath)	Legt den Beschneidungsbereich dieses Graphics auf die angegebene GraphicsPathfest.

SetClip(Region, CombineMode)

Quelle:

Graphics.cs

Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und die angegebene Regionkombiniert.

C#

public void SetClip (System.Drawing.Region region, System.Drawing.Drawing2D.CombineMode combineMode);

Parameter

region

Region

Region kombinieren.

combineMode

CombineMode

Member aus der CombineMode-Aufzählung, die den zu verwendenden Kombinationsvorgang angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein kleines Rechteck für den Beschneidungsbereich.

• Legt den Clippingbereich auf das Rechteck mit dem Replace-Element fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Rechteck.

C#

private void SetClipRegionCombine(PaintEventArgs e)
{

    // Create region for clipping.
    Region clipRegion = new Region(new Rectangle(0, 0, 100, 100));

    // Set clipping region of graphics to region.
    e.Graphics.SetClip(clipRegion, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

SetClip(RectangleF, CombineMode)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und das durch eine RectangleF Struktur angegebene Rechteck kombiniert.

C#

public void SetClip (System.Drawing.RectangleF rect, System.Drawing.Drawing2D.CombineMode combineMode);

Parameter

rect

RectangleF

RectangleF Zu kombinierende Struktur.

combineMode

CombineMode

Member der CombineMode-Aufzählung, die den zu verwendenden Kombinationsvorgang angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein kleines Rechteck für den Beschneidungsbereich.

• Legt den Clippingbereich auf das Rechteck mit dem Replace-Element fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Rechteck.

C#

private void SetClipRectangleFCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

SetClip(Rectangle, CombineMode)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und das durch eine Rectangle Struktur angegebene Rechteck kombiniert.

C#

public void SetClip (System.Drawing.Rectangle rect, System.Drawing.Drawing2D.CombineMode combineMode);

Parameter

rect

Rectangle

Rectangle Zu kombinierende Struktur.

combineMode

CombineMode

Member der CombineMode-Aufzählung, die den zu verwendenden Kombinationsvorgang angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein kleines Rechteck für den Beschneidungsbereich.

• Legt den Clippingbereich auf das Rechteck mit dem Replace-Element fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Rechteck.

C#

private void SetClipRectangleCombine(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

SetClip(Graphics, CombineMode)

Quelle:

Graphics.cs

Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Kombinationsvorgangs des aktuellen Clipbereichs und der Clip-Eigenschaft der angegebenen Graphicsfest.

C#

public void SetClip (System.Drawing.Graphics g, System.Drawing.Drawing2D.CombineMode combineMode);

Parameter

g

Graphics

Graphics, die den zu kombinierenden Clipbereich angibt.

combineMode

CombineMode

Member der CombineMode-Aufzählung, die den zu verwendenden Kombinationsvorgang angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers sowie thisForm, des Form für das Beispiel handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt eine temporäre Graphics aus dem thisFormForm des Beispiels.

• Legt den Beschneidungsbereich des temporären Graphics auf ein kleines Quadrat fest.

• Aktualisiert den Beschneidungsbereich des Grafikobjekts des Formulars mit dem neuen Graphics mit dem Replace-Element.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Quadrat.

C#

private void SetClipGraphicsCombine(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics, CombineMode.Replace);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}

SetClip(GraphicsPath, CombineMode)

Quelle:

Graphics.cs

Legt den Clippingbereich dieser Graphics auf das Ergebnis des angegebenen Vorgangs fest, der den aktuellen Clipbereich und die angegebene GraphicsPathkombiniert.

C#

public void SetClip (System.Drawing.Drawing2D.GraphicsPath path, System.Drawing.Drawing2D.CombineMode combineMode);

Parameter

path

GraphicsPath

GraphicsPath kombinieren.

combineMode

CombineMode

Member der CombineMode-Aufzählung, die den zu verwendenden Kombinationsvorgang angibt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen Grafikpfad und fügt dem Pfad eine Auslassungspunkte hinzu.

• Legt den Clippingbereich auf den elliptischen Pfad mit dem Replace-Element fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist eine gefüllte, schwarze Ellipse.

C#

private void SetClipPathCombine(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath, CombineMode.Replace);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Hinweise

Wenn der durch den Parameter path dargestellte Grafikpfad nicht geschlossen wird, wird ein zusätzliches Segment vom letzten Punkt zum ersten Punkt hinzugefügt, um den Pfad zu schließen.

SetClip(RectangleF)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf das durch eine RectangleF Struktur angegebene Rechteck fest.

C#

public void SetClip (System.Drawing.RectangleF rect);

Parameter

rect

RectangleF

RectangleF Struktur, die den neuen Clipbereich darstellt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein kleines Rechteck für den Beschneidungsbereich.

• Legt den Clippingbereich auf das Rechteck fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Rechteck.

C#

private void SetClipRectangleF(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    RectangleF clipRect = new RectangleF(0.0F, 0.0F, 100.0F, 100.0F);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

SetClip(Rectangle)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf das durch eine Rectangle Struktur angegebene Rechteck fest.

C#

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

Parameter

rect

Rectangle

Rectangle Struktur, die den neuen Clipbereich darstellt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt ein kleines Rechteck für den Beschneidungsbereich.

• Legt den Clippingbereich auf das Rechteck fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Rechteck.

C#

private void SetClipRectangle(PaintEventArgs e)
{

    // Create rectangle for clipping region.
    Rectangle clipRect = new Rectangle(0, 0, 100, 100);

    // Set clipping region of graphics to rectangle.
    e.Graphics.SetClip(clipRect);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

SetClip(Graphics)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf die Clip-Eigenschaft der angegebenen Graphicsfest.

C#

public void SetClip (System.Drawing.Graphics g);

Parameter

g

Graphics

Graphics, aus dem der neue Clipbereich entnommen werden soll.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers sowie thisForm, des Form für das Beispiel handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt eine temporäre Graphics aus dem thisFormForm des Beispiels.

• Legt den Beschneidungsbereich des temporären Graphics auf ein kleines Quadrat fest.

• Aktualisiert den Beschneidungsbereich des Grafikobjekts des Formulars auf die des temporären Graphics.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist ein kleines, gefülltes, schwarzes Quadrat.

C#

private void SetClipGraphics(PaintEventArgs e)
{

    // Create temporary graphics object and set its clipping region.
    Graphics newGraphics = this.CreateGraphics();
    newGraphics.SetClip(new Rectangle(0, 0, 100, 100));

    // Update clipping region of graphics to clipping region of new

    // graphics.
    e.Graphics.SetClip(newGraphics);

    // Fill rectangle to demonstrate clip region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);

    // Release new graphics.
    newGraphics.Dispose();
}

SetClip(GraphicsPath)

Quelle:

Graphics.cs

Legt den Beschneidungsbereich dieses Graphics auf die angegebene GraphicsPathfest.

C#

public void SetClip (System.Drawing.Drawing2D.GraphicsPath path);

Parameter

path

GraphicsPath

GraphicsPath, die den neuen Clipbereich darstellt.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen Grafikpfad und fügt dem Pfad eine Auslassungspunkte hinzu.

• Legt den Clippingbereich auf den elliptischen Pfad fest.

• Füllt ein großes Rechteck mit einem einfarbigen schwarzen Pinsel.

Das Ergebnis ist eine gefüllte, schwarze Ellipse.

C#

private void SetClipPath(PaintEventArgs e)
{

    // Create graphics path.
    GraphicsPath clipPath = new GraphicsPath();
    clipPath.AddEllipse(0, 0, 200, 100);

    // Set clipping region to path.
    e.Graphics.SetClip(clipPath);

    // Fill rectangle to demonstrate clipping region.
    e.Graphics.FillRectangle(new SolidBrush(Color.Black), 0, 0, 500, 300);
}

Hinweise

Wenn der durch den Parameter path dargestellte Grafikpfad nicht geschlossen wird, wird ein zusätzliches Segment vom letzten Punkt zum ersten Punkt hinzugefügt, um den Pfad zu schließen.