Gerenciamento de estado de um objeto Graphics

Artigo
08/25/2010

The Graphics classe é a essência do GDI+. Para desenhar tudo, você obtém um Graphics objeto, conjunto suas propriedades e chamar seus métodos DrawLine, DrawImage, DrawStringe assim por diante).

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 de elementos gráficos

A Graphics objeto mais de fornecer métodos de desenho, sistema autônomo DrawLine e DrawRectangle. A Graphics objeto também mantém o estado de elementos gráficos, que pode ser dividido em categorias a seguir:

Configurações de qualidade
Transformações
Região de recorte

Configurações de qualidade

A Graphics objeto tem várias propriedades que influenciam a qualidade dos itens que são desenhados. Por exemplo, você pode conjunto o TextRenderingHint propriedade para especificar o tipo de suavização (se houver) aplicado ao texto. Outras propriedades que influenciam a qualidade são SmoothingMode, CompositingMode, CompositingQuality, e InterpolationMode.

O exemplo a seguir desenha dois elipses, um com o modo de suavização conjunto para AntiAlias e outra com o modo de suavização conjunto para HighSpeed:

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

A Graphics objeto mantém duas transformações (mundo e página) que são aplicadas a todos os itens desenhados pelo que Graphics objeto. Qualquer transformação afim pode ser armazenada na transformação global.Transformações afim incluem dimensionamento, girar, refletir, inclinação e conversão.A transformação de página pode ser usada para dimensionamento e para alteração de unidades (por exemplo, os pixels em polegadas).Para obter mais informações, consulte Sistemas de coordenada e transformações.

O exemplo a seguir define as transformações do mundo e a página de um Graphics objeto. transformação global é conjunto para uma rotação de 30 graus.A transformação de página é definida para que sistema autônomo coordenadas passadas para o segundo DrawEllipse serão tratados sistema autônomo milímetros, em vez de pixels. O código faz duas chamadas idênticas para o DrawEllipse método. transformação global é aplicada à primeira DrawEllipse telefonar e as duas transformações (mundo e página) são aplicadas ao segundo DrawEllipse Chame.

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 duas elipses.Observe que a rotação de 30 graus é sobre a origem do sistema de coordenada (canto superior esquerdo da área de cliente), não sobre os centros de reticências.Também observe que a largura da caneta de 1 significa que 1 pixel para a primeira elipse e 1 milímetro para a segunda elipse.

Região de recorte

A Graphics objeto mantém uma região de recorte se aplica a todos os itens desenhados pelo que Graphics objeto. Você pode conjunto a região de recorte chamando o SetClip método.

O exemplo a seguir cria uma região em forma de sinal de mais formando a união de dois retângulos.Essa região é designada sistema autônomo a região de recorte de um Graphics objeto. Em seguida, o código desenha duas linhas que são restritas ao interior da região 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.