Graphics.SetClip Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

Imposta l'area di ritaglio di questo Graphics sulla proprietà Clip del Graphicsspecificato.

Overload

SetClip(Region, CombineMode)	Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata che combina l'area di ritaglio corrente e il Regionspecificato.
SetClip(RectangleF, CombineMode)	Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata combinando l'area di ritaglio corrente e il rettangolo specificato da una struttura RectangleF.
SetClip(Rectangle, CombineMode)	Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata combinando l'area di ritaglio corrente e il rettangolo specificato da una struttura Rectangle.
SetClip(Graphics, CombineMode)	Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione di combinazione specificata dell'area di ritaglio corrente e della proprietà Clip del Graphicsspecificato.
SetClip(GraphicsPath, CombineMode)	Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata che combina l'area di ritaglio corrente e il GraphicsPathspecificato.
SetClip(RectangleF)	Imposta l'area di ritaglio di questo Graphics sul rettangolo specificato da una struttura RectangleF.
SetClip(Rectangle)	Imposta l'area di ritaglio di questo Graphics sul rettangolo specificato da una struttura Rectangle.
SetClip(Graphics)	Imposta l'area di ritaglio di questo Graphics sulla proprietà Clip del Graphicsspecificato.
SetClip(GraphicsPath)	Imposta l'area di ritaglio di questo Graphics sull'oggetto specificato GraphicsPath.

SetClip(Region, CombineMode)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata che combina l'area di ritaglio corrente e il Regionspecificato.

C#

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

Parametri

region

Region

Region da combinare.

combineMode

CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un piccolo rettangolo per l'area di ritaglio.

• Imposta l'area di ritaglio sul rettangolo con il membro Replace.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un rettangolo piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata combinando l'area di ritaglio corrente e il rettangolo specificato da una struttura RectangleF.

C#

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

Parametri

rect

RectangleF

RectangleF struttura da combinare.

combineMode

CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un piccolo rettangolo per l'area di ritaglio.

• Imposta l'area di ritaglio sul rettangolo con il membro Replace.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un rettangolo piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata combinando l'area di ritaglio corrente e il rettangolo specificato da una struttura Rectangle.

C#

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

Parametri

rect

Rectangle

Rectangle struttura da combinare.

combineMode

CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un piccolo rettangolo per l'area di ritaglio.

• Imposta l'area di ritaglio sul rettangolo con il membro Replace.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un rettangolo piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione di combinazione specificata dell'area di ritaglio corrente e della proprietà Clip del Graphicsspecificato.

C#

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

Parametri

g

Graphics

Graphics che specifica l'area di ritaglio da combinare.

combineMode

CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint, nonché thisForm, il Form per l'esempio. Il codice esegue le azioni seguenti:

• Crea un Graphics temporaneo dal thisFormForm dell'esempio.

• Imposta l'area di ritaglio del Graphics temporaneo su un piccolo quadrato.

• Aggiorna l'area di ritaglio dell'oggetto grafico del modulo a quella del nuovo Graphics con il membro Replace.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un quadrato piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul risultato dell'operazione specificata che combina l'area di ritaglio corrente e il GraphicsPathspecificato.

C#

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

Parametri

path

GraphicsPath

GraphicsPath da combinare.

combineMode

CombineMode

Membro dell'enumerazione CombineMode che specifica l'operazione di combinazione da utilizzare.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un percorso grafico e aggiunge un'ellisse al percorso.

• Imposta l'area di ritaglio sul percorso ellittico con il membro Replace.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un'ellisse nera piena.

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

Commenti

Se il percorso grafico rappresentato dal parametro path non è chiuso, viene aggiunto un segmento aggiuntivo dall'ultimo punto al primo punto per chiudere il percorso.

SetClip(RectangleF)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul rettangolo specificato da una struttura RectangleF.

C#

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

Parametri

rect

RectangleF

RectangleF struttura che rappresenta la nuova area di ritaglio.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un piccolo rettangolo per l'area di ritaglio.

• Imposta l'area di ritaglio sul rettangolo.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un rettangolo piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sul rettangolo specificato da una struttura Rectangle.

C#

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

Parametri

rect

Rectangle

Rectangle struttura che rappresenta la nuova area di ritaglio.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un piccolo rettangolo per l'area di ritaglio.

• Imposta l'area di ritaglio sul rettangolo.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un rettangolo piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sulla proprietà Clip del Graphicsspecificato.

C#

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

Parametri

g

Graphics

Graphics da cui prendere la nuova area clip.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint, nonché thisForm, il Form per l'esempio. Il codice esegue le azioni seguenti:

• Crea un Graphics temporaneo dal thisFormForm dell'esempio.

• Imposta l'area di ritaglio del Graphics temporaneo su un piccolo quadrato.

• Aggiorna l'area di ritaglio dell'oggetto grafico del form a quella del Graphicstemporaneo .

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un quadrato piccolo, pieno, nero.

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)

Origine:

Graphics.cs

Imposta l'area di ritaglio di questo Graphics sull'oggetto specificato GraphicsPath.

C#

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

Parametri

path

GraphicsPath

GraphicsPath che rappresenta la nuova area di ritaglio.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea un percorso grafico e aggiunge un'ellisse al percorso.

• Imposta l'area di ritaglio sul percorso ellittico.

• Riempie un grande rettangolo con un pennello nero a tinta unita.

Il risultato è un'ellisse nera piena.

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

Commenti

Se il percorso grafico rappresentato dal parametro path non è chiuso, viene aggiunto un segmento aggiuntivo dall'ultimo punto al primo punto per chiudere il percorso.