Canetas, linhas e retângulos em GDI+

Artigo
08/01/2011

Para desenhar linhas com GDI+ você precisa criar um Graphics objeto e um Pen objeto. O Graphics objeto fornece os métodos que efetivamente fazem o desenho e o Pen objeto armazena os atributos, como a cor da linha, largura e estilo.

Desenhando uma linha

Para desenhar uma linha, chame o DrawLine método de Graphics objeto. O Pen objeto é passado como um dos argumentos para o DrawLine método. O exemplo a seguir desenha uma linha do ponto (4, 2) para o ponto (12, 6):

        myGraphics.DrawLine(myPen, 4, 2, 12, 6)

myGraphics.DrawLine(myPen, 4, 2, 12, 6);

DrawLineé um método sobrecarregado da Graphics classe, portanto, há várias maneiras que você pode fornecer com argumentos. Por exemplo, construir duas Point objetos e passar a Point objetos como argumentos para o DrawLine método:

        Dim myStartPoint As New Point(4, 2)
        Dim myEndPoint As New Point(12, 6)
        myGraphics.DrawLine(myPen, myStartPoint, myEndPoint)

Point myStartPoint = new Point(4, 2);
Point myEndPoint = new Point(12, 6);
myGraphics.DrawLine(myPen, myStartPoint, myEndPoint);

Construindo uma caneta

Você pode especificar determinados atributos ao construir um Pen objeto. Por exemplo, um Pen construtor permite que você especifique a cor e largura. O exemplo a seguir desenha uma linha azul da largura de 2 de (0, 0) para (30, 60):

        Dim myPen As New Pen(Color.Blue, 2)
        myGraphics.DrawLine(myPen, 0, 0, 60, 30)

Pen myPen = new Pen(Color.Blue, 2);
myGraphics.DrawLine(myPen, 0, 0, 60, 30);

Linhas tracejadas e Caps de linha

O Pen objeto também expõe as propriedades, como DashStyle, que pode ser usado para especificar os recursos da linha. O exemplo a seguir desenha uma linha tracejada de (50, 100) para (300, 80):

        myPen.DashStyle = DashStyle.Dash
        myGraphics.DrawLine(myPen, 100, 50, 300, 80)

myPen.DashStyle = DashStyle.Dash;
myGraphics.DrawLine(myPen, 100, 50, 300, 80);

Você pode usar as propriedades de Pen objeto para definir muitas das mais atributos da linha. O StartCap e EndCap propriedades especificam a aparência das extremidades da linha; as extremidades podem ser simples, quadrado, arredondado, triangular, ou uma forma personalizada. O LineJoin propriedade permite que você especificar se linhas conectadas são mitered (associadas com cantos acentuados), chanfradas, arredondadas ou recortadas. A ilustração a seguir mostra as linhas com vários estilos de arremate e associação.

Linhas

Um retângulo de desenho.

Desenhar retângulos com GDI+ é semelhante ao desenho de linhas. Para desenhar um retângulo, você precisa de um Graphics objeto e um Pen objeto. O Graphics objeto fornece um DrawRectangle método e o Pen objeto armazena os atributos, como a largura de linha e cor. O Pen objeto é passado como um dos argumentos para o DrawRectangle método. O exemplo a seguir desenha um retângulo com seu canto superior esquerdo em (100, 50), uma largura de 80 e uma altura de 40:

        myGraphics.DrawRectangle(myPen, 100, 50, 80, 40)

myGraphics.DrawRectangle(myPen, 100, 50, 80, 40);

DrawRectangleé um método sobrecarregado da Graphics classe, portanto, há várias maneiras que você pode fornecer com argumentos. Por exemplo, você pode construir um Rectangle object e passar a Rectangle o objeto para o DrawRectangle o método como um argumento:

        Dim myRectangle As New Rectangle(100, 50, 80, 40)
        myGraphics.DrawRectangle(myPen, myRectangle)

Rectangle myRectangle = new Rectangle(100, 50, 80, 40);
myGraphics.DrawRectangle(myPen, myRectangle);

A Rectangle objeto possui métodos e propriedades para manipular e reunir informações sobre o retângulo. Por exemplo, o Inflate e Offset métodos de alterar o tamanho e posição do retângulo. O IntersectsWith método informa se o retângulo intercepta outro dado de retângulo e o Contains método informa se um determinado ponto está dentro do retângulo.