Ler em inglês

Partilhar via


Graphics.Clip Propriedade

Definição

Obtém ou define um Region que limita a região desenho desse Graphics.

C#
public System.Drawing.Region Clip { get; set; }

Valor da propriedade

A Region que limita a parte desse Graphics que está atualmente disponível para o desenho.

Exemplos

O exemplo de código a seguir demonstra o uso da Clip propriedade . Este exemplo foi projetado para ser usado com Windows Forms. Cole o código em um formulário e chame o SetAndFillClip método ao manipular o evento do Paint formulário, passando e como PaintEventArgs.

C#
private void SetAndFillClip(PaintEventArgs e)
{

    // Set the Clip property to a new region.
    e.Graphics.Clip = new Region(new Rectangle(10, 10, 100, 200));

    // Fill the region.
    e.Graphics.FillRegion(Brushes.LightSalmon, e.Graphics.Clip);

    // Demonstrate the clip region by drawing a string
    // at the outer edge of the region.
    e.Graphics.DrawString("Outside of Clip", new Font("Arial", 
        12.0F, FontStyle.Regular), Brushes.Black, 0.0F, 0.0F);
}

Comentários

Modificar o Region objeto retornado pela propriedade não afeta o Clip desenho subsequente com o Graphics objeto . Para alterar a região de clipe, substitua o valor da Clip propriedade por um novo Region objeto . Para determinar se a região de recorte é infinita, recupere a Clip propriedade e chame seu IsInfinite método.

Aplica-se a

Produto Versões
.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
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9