Graphics.SetClip Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

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

Define a região de recorte desta Graphics para a propriedade Clip do Graphicsespecificado.

Sobrecargas

SetClip(Region, CombineMode)	Define a região de recorte desta Graphics como o resultado da operação especificada combinando a região do clipe atual e o Regionespecificado.
SetClip(RectangleF, CombineMode)	Define a região de recorte dessa Graphics como o resultado da operação especificada combinando a região do clipe atual e o retângulo especificado por uma estrutura RectangleF.
SetClip(Rectangle, CombineMode)	Define a região de recorte dessa Graphics como o resultado da operação especificada combinando a região do clipe atual e o retângulo especificado por uma estrutura Rectangle.
SetClip(Graphics, CombineMode)	Define a região de recorte desta Graphics como o resultado da operação de combinação especificada da região de clipe atual e da propriedade Clip do Graphicsespecificado.
SetClip(GraphicsPath, CombineMode)	Define a região de recorte desta Graphics como o resultado da operação especificada combinando a região do clipe atual e o GraphicsPathespecificado.
SetClip(RectangleF)	Define a região de recorte dessa Graphics para o retângulo especificado por uma estrutura de RectangleF.
SetClip(Rectangle)	Define a região de recorte dessa Graphics para o retângulo especificado por uma estrutura de Rectangle.
SetClip(Graphics)	Define a região de recorte desta Graphics para a propriedade Clip do Graphicsespecificado.
SetClip(GraphicsPath)	Define a região de recorte deste Graphics para o GraphicsPathespecificado.

SetClip(Region, CombineMode)

Origem:

Graphics.cs

Define a região de recorte desta Graphics como o resultado da operação especificada combinando a região do clipe atual e o Regionespecificado.

C#

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

Parâmetros

region

Region

Region combinar.

combineMode

CombineMode

Membro da enumeração CombineMode que especifica a operação de combinação a ser usada.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um pequeno retângulo para a região de recorte.

• Define a região de recorte para o retângulo com o membro Replace.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um pequeno retângulo preto, preenchido.

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)

Origem:

Graphics.cs

Define a região de recorte dessa Graphics como o resultado da operação especificada combinando a região do clipe atual e o retângulo especificado por uma estrutura RectangleF.

C#

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

Parâmetros

rect

RectangleF

RectangleF estrutura a ser combinada.

combineMode

CombineMode

Membro da enumeração CombineMode que especifica a operação de combinação a ser usada.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um pequeno retângulo para a região de recorte.

• Define a região de recorte para o retângulo com o membro Replace.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um pequeno retângulo preto, preenchido.

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)

Origem:

Graphics.cs

Define a região de recorte dessa Graphics como o resultado da operação especificada combinando a região do clipe atual e o retângulo especificado por uma estrutura Rectangle.

C#

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

Parâmetros

rect

Rectangle

Rectangle estrutura a ser combinada.

combineMode

CombineMode

Membro da enumeração CombineMode que especifica a operação de combinação a ser usada.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um pequeno retângulo para a região de recorte.

• Define a região de recorte para o retângulo com o membro Replace.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um pequeno retângulo preto, preenchido.

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)

Origem:

Graphics.cs

Define a região de recorte desta Graphics como o resultado da operação de combinação especificada da região de clipe atual e da propriedade Clip do Graphicsespecificado.

C#

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

Parâmetros

g

Graphics

Graphics que especifica a região do clipe a ser combinada.

combineMode

CombineMode

Membro da enumeração CombineMode que especifica a operação de combinação a ser usada.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint, bem como thisForm, o Form para o exemplo. O código executa as seguintes ações:

• Cria um Graphics temporário do thisFormForm do exemplo.

• Define a região de recorte do Graphics temporário como um quadrado pequeno.

• Atualiza a região de recorte do objeto gráfico do formulário para a do novo Graphics com o membro Replace.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um quadrado pequeno, cheio e preto.

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)

Origem:

Graphics.cs

Define a região de recorte desta Graphics como o resultado da operação especificada combinando a região do clipe atual e o GraphicsPathespecificado.

C#

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

Parâmetros

path

GraphicsPath

GraphicsPath combinar.

combineMode

CombineMode

Membro da enumeração CombineMode que especifica a operação de combinação a ser usada.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um caminho gráfico e adiciona uma elipse ao caminho.

• Define a região de recorte para o caminho elíptico com o membro Replace.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é uma elipse preta preenchida.

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

Comentários

Se o caminho gráfico representado pelo parâmetro path não for fechado, um segmento adicional será adicionado do último ponto ao primeiro ponto para fechar o caminho.

SetClip(RectangleF)

Origem:

Graphics.cs

Define a região de recorte dessa Graphics para o retângulo especificado por uma estrutura de RectangleF.

C#

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

Parâmetros

rect

RectangleF

RectangleF estrutura que representa a nova região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um pequeno retângulo para a região de recorte.

• Define a região de recorte como o retângulo.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um pequeno retângulo preto, preenchido.

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)

Origem:

Graphics.cs

Define a região de recorte dessa Graphics para o retângulo especificado por uma estrutura de Rectangle.

C#

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

Parâmetros

rect

Rectangle

Rectangle estrutura que representa a nova região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um pequeno retângulo para a região de recorte.

• Define a região de recorte como o retângulo.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um pequeno retângulo preto, preenchido.

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)

Origem:

Graphics.cs

Define a região de recorte desta Graphics para a propriedade Clip do Graphicsespecificado.

C#

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

Parâmetros

g

Graphics

Graphics da qual usar a nova região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint, bem como thisForm, o Form para o exemplo. O código executa as seguintes ações:

• Cria um Graphics temporário do thisFormForm do exemplo.

• Define a região de recorte do Graphics temporário como um quadrado pequeno.

• Atualiza a região de recorte do objeto gráfico do formulário para a do Graphicstemporário.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é um quadrado pequeno, cheio e preto.

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)

Origem:

Graphics.cs

Define a região de recorte deste Graphics para o GraphicsPathespecificado.

C#

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

Parâmetros

path

GraphicsPath

GraphicsPath que representa a nova região do clipe.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código executa as seguintes ações:

• Cria um caminho gráfico e adiciona uma elipse ao caminho.

• Define a região de recorte como o caminho elíptico.

• Preenche um retângulo grande com um pincel preto sólido.

O resultado é uma elipse preta preenchida.

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

Comentários

Se o caminho gráfico representado pelo parâmetro path não for fechado, um segmento adicional será adicionado do último ponto ao primeiro ponto para fechar o caminho.