Gerenciando o Estado de um Objeto Gráfico

  • Artigo

A Graphics classe está no coração do GDI+. Para desenhar qualquer coisa, você obtém um Graphics objeto, define suas propriedades e chama seus métodos DrawLine, , , DrawStringDrawImagee afins).

O exemplo a seguir chama o DrawRectangle método de um Graphics objeto. O primeiro argumento passado para o DrawRectangle método é um Pen objeto.

Dim graphics As Graphics = e.Graphics  
Dim pen As New Pen(Color.Blue) ' Opaque blue  
graphics.DrawRectangle(pen, 10, 10, 200, 100)  

Graphics graphics = e.Graphics;  
Pen pen = new Pen(Color.Blue);  // Opaque blue  
graphics.DrawRectangle(pen, 10, 10, 200, 100);

Estado gráfico

Um Graphics objeto faz mais do que fornecer métodos de desenho, como DrawLine e DrawRectangle. Um Graphics objeto também mantém o estado gráfico, que pode ser dividido nas seguintes categorias:

  • Configurações de qualidade

  • Transformações

  • Área de recorte

Configurações de Qualidade

Um Graphics objeto tem várias propriedades que influenciam a qualidade dos itens que são desenhados. Por exemplo, você pode definir a TextRenderingHint propriedade para especificar o tipo de suavização de borda (se houver) aplicada ao texto. Outras propriedades que influenciam a qualidade são SmoothingMode, , CompositingModeCompositingQualitye InterpolationMode.

O exemplo a seguir desenha duas reticências, uma com o modo de suavização definido como e outra com o modo de suavização definido como AntiAliasHighSpeed:

Dim graphics As Graphics = e.Graphics  
Dim pen As New Pen(Color.Blue)  
  
graphics.SmoothingMode = SmoothingMode.AntiAlias  
graphics.DrawEllipse(pen, 0, 0, 200, 100)  
graphics.SmoothingMode = SmoothingMode.HighSpeed  
graphics.DrawEllipse(pen, 0, 150, 200, 100)  

Graphics graphics = e.Graphics;  
Pen pen = new Pen(Color.Blue);  
  
graphics.SmoothingMode = SmoothingMode.AntiAlias;  
graphics.DrawEllipse(pen, 0, 0, 200, 100);  
graphics.SmoothingMode = SmoothingMode.HighSpeed;  
graphics.DrawEllipse(pen, 0, 150, 200, 100);

Transformações

Um Graphics objeto mantém duas transformações (mundo e página) que são aplicadas a todos os itens desenhados por esse Graphics objeto. Qualquer transformação afim pode ser armazenada na transformação global. Transformações afins incluem colocação em escala, rotação, reflexão, distorção e translação. A transformação de página pode ser usada para colocação em escala e para alterar unidades (por exemplo, pixels em polegadas). Para obter mais informações, consulte Sistemas de Coordenadas e Transformações.

O exemplo a seguir define as transformações de mundo e página de um Graphics objeto. A transformação global é definida com uma rotação de 30 graus. A transformação de página é definida para que as coordenadas passadas para o segundo DrawEllipse sejam tratadas como milímetros em vez de pixels. O código faz duas chamadas idênticas para o DrawEllipse método. A transformação do mundo é aplicada à primeira DrawEllipse chamada, e ambas as transformações (mundo e página) são aplicadas à segunda DrawEllipse chamada.

Dim graphics As Graphics = e.Graphics  
Dim pen As New Pen(Color.Red)  
  
graphics.ResetTransform()  
graphics.RotateTransform(30) ' world transformation  
graphics.DrawEllipse(pen, 0, 0, 100, 50)  
graphics.PageUnit = GraphicsUnit.Millimeter ' page transformation  
graphics.DrawEllipse(pen, 0, 0, 100, 50)  

Graphics graphics = e.Graphics;  
Pen pen = new Pen(Color.Red);
  
graphics.ResetTransform();  
graphics.RotateTransform(30);                    // world transformation  
graphics.DrawEllipse(pen, 0, 0, 100, 50);  
graphics.PageUnit = GraphicsUnit.Millimeter;     // page transformation  
graphics.DrawEllipse(pen, 0, 0, 100, 50);

A ilustração a seguir mostra as duas elipses. Observe que a rotação de 30 graus é sobre a origem do sistema de coordenadas (canto superior esquerdo da área de cliente), e não sobre os centros das elipses. Observe também que a largura da caneta de 1 significa 1 pixel para a primeira elipse e 1 milímetro para a segunda elipse.

Illustration that shows two ellipses: rotation and pen width.

Área de recorte

Um Graphics objeto mantém uma região de recorte que se aplica a todos os itens desenhados por esse Graphics objeto. Você pode definir a região de recorte chamando o SetClip método.

O exemplo a seguir cria uma região em forma de mais (+), formando a união de dois retângulos. Essa região é designada como a região de recorte de um Graphics objeto. Em seguida, o código desenha duas linhas restritas ao interior da área de recorte.

Dim graphics As Graphics = e.Graphics  
  
' Opaque red, width 5  
Dim pen As New Pen(Color.Red, 5)  
  
' Opaque aqua  
Dim brush As New SolidBrush(Color.FromArgb(255, 180, 255, 255))  
  
' Create a plus-shaped region by forming the union of two rectangles.  
Dim [region] As New [Region](New Rectangle(50, 0, 50, 150))  
[region].Union(New Rectangle(0, 50, 150, 50))  
graphics.FillRegion(brush, [region])  
  
' Set the clipping region.  
graphics.SetClip([region], CombineMode.Replace)  
  
' Draw two clipped lines.  
graphics.DrawLine(pen, 0, 30, 150, 160)  
graphics.DrawLine(pen, 40, 20, 190, 150)  

Graphics graphics = e.Graphics;  
  
// Opaque red, width 5  
Pen pen = new Pen(Color.Red, 5);
  
// Opaque aqua  
SolidBrush brush = new SolidBrush(Color.FromArgb(255, 180, 255, 255));
  
// Create a plus-shaped region by forming the union of two rectangles.  
Region region = new Region(new Rectangle(50, 0, 50, 150));  
region.Union(new Rectangle(0, 50, 150, 50));  
graphics.FillRegion(brush, region);  
  
// Set the clipping region.  
graphics.SetClip(region, CombineMode.Replace);  
  
// Draw two clipped lines.  
graphics.DrawLine(pen, 0, 30, 150, 160);  
graphics.DrawLine(pen, 40, 20, 190, 150);

A ilustração a seguir mostra as linhas cortadas:

Diagram that shows the limited clip region.

Confira também