Como: Usar o corte com uma região

Uma das propriedades da Graphics classe é a região do clipe. Todos os desenhos feitos um determinado Graphics objeto é restrito para a região de clipe da que Graphics objeto. Você pode definir a região do clipe, chamando o SetClip método.

Exemplo

O exemplo seguinte constrói um caminho que consiste em um único polígono. Em seguida, o código constrói uma região, com base no caminho. A região é passada para o SetClip o método de um Graphics objeto e, em seguida, duas seqüências de caracteres são desenhados.

A ilustração a seguir mostra as seqüências de caracteres cortadas.

        ' Create a path that consists of a single polygon.
        Dim polyPoints As Point() = { _
           New Point(10, 10), _
           New Point(150, 10), _
           New Point(100, 75), _
           New Point(100, 150)}
        Dim path As New GraphicsPath()
        path.AddPolygon(polyPoints)

        ' Construct a region based on the path.
        Dim [region] As New [Region](path)

        ' Draw the outline of the region.
        Dim pen As Pen = Pens.Black
        e.Graphics.DrawPath(pen, path)

        ' Set the clipping region of the Graphics object.
        e.Graphics.SetClip([region], CombineMode.Replace)

        ' Draw some clipped strings.
        Dim fontFamily As New FontFamily("Arial")
        Dim font As New Font( _
           fontFamily, _
           36, _
           FontStyle.Bold, _
           GraphicsUnit.Pixel)
        Dim solidBrush As New SolidBrush(Color.FromArgb(255, 255, 0, 0))

        e.Graphics.DrawString( _
           "A Clipping Region", _
           font, _
           solidBrush, _
           New PointF(15, 25))

        e.Graphics.DrawString( _
           "A Clipping Region", _
           font, _
           solidBrush, _
           New PointF(15, 68))

     // Create a path that consists of a single polygon.
     Point[] polyPoints = {
new Point(10, 10),
new Point(150, 10), 
new Point(100, 75),
new Point(100, 150)};
     GraphicsPath path = new GraphicsPath();
     path.AddPolygon(polyPoints);

     // Construct a region based on the path.
     Region region = new Region(path);

     // Draw the outline of the region.
     Pen pen = Pens.Black;
     e.Graphics.DrawPath(pen, path);

     // Set the clipping region of the Graphics object.
     e.Graphics.SetClip(region, CombineMode.Replace);

     // Draw some clipped strings.
     FontFamily fontFamily = new FontFamily("Arial");
     Font font = new Font(
        fontFamily,
        36, FontStyle.Bold,
        GraphicsUnit.Pixel);
     SolidBrush solidBrush = new SolidBrush(Color.FromArgb(255, 255, 0, 0));

     e.Graphics.DrawString(
        "A Clipping Region",
        font, solidBrush,
        new PointF(15, 25));

     e.Graphics.DrawString(
        "A Clipping Region",
        font,
        solidBrush,
        new PointF(15, 68));

Compilando o código

O exemplo anterior é projetado para uso com o Windows Forms e requer PaintEventArgs e, que é um parâmetro de PaintEventHandler.

Consulte também

Conceitos

Regiões em GDI+

Outros recursos

O uso de regiões