Como: Criar objetos gráficos para desenho

Artigo
08/25/2010

Antes de você pode desenhar linhas e formas, processar texto, ou exibir e manipular imagens com GDI+, você precisará criar um Graphics objeto. The Graphics objeto representa um GDI+ superfície de desenho e é o objeto que é usado para criar imagens gráficas.

Há duas etapas para trabalhar com elementos gráficos:

Criando um Graphics objeto.
Usando o Graphics objeto para desenhar linhas e formas, processar texto, ou exibir e manipular imagens.

Criando um objeto Graphics

É possível criar um objeto gráfico em uma variedade de formas.

Para criar um objeto gráfico

Recebe uma referência a um objeto gráfico sistema autônomo parte do PaintEventArgs no Paint evento de um formulário ou controle. Isso geralmente é como você obter uma referência a um objeto gráfico ao criar o código de pintura para um controle.

- ou -
telefonar the CreateGraphics método de um controle ou formulário para obter uma referência a um Graphics objeto que representa a superfície de desenho desse controle ou formulário. Use este método se desejar desenhar em um formulário ou controle que já existe.

- ou -
Criar um Graphics objeto a partir de qualquer objeto que herda de Image. Essa abordagem é útil quando você quiser alterar uma imagem já existente.

As seções a seguir fornecem detalhes sobre cada um desses processos.

PaintEventArgs no manipulador de eventos do Paint

Ao programar o PaintEventHandler para controles, um objeto gráfico é fornecido sistema autônomo um do PaintEventArgs.

Para obter uma referência a um objeto Graphics a partir PaintEventArgs no evento Paint

Declarar o Graphics objeto.
Atribuir a variável para se referir a Graphics objeto passado sistema autônomo parte do PaintEventArgs.
Inserir código para pintar o formulário ou controle.

O exemplo a seguir mostra como fazer referência a um Graphics objeto das PaintEventArgs no Paint evento:

Private Sub Form1_Paint(sender As Object, pe As PaintEventArgs) Handles _
   MyBase.Paint
   ' Declares the Graphics object and sets it to the Graphics object
   ' supplied in the PaintEventArgs.
   Dim g As Graphics = pe.Graphics
   ' Insert code to paint the form here.
End Sub

private void Form1_Paint(object sender, 
   System.Windows.Forms.PaintEventArgs pe) 
{
   // Declares the Graphics object and sets it to the Graphics object
   // supplied in the PaintEventArgs.
   Graphics g = pe.Graphics;
   // Insert code to paint the form here.
}

private:
   void Form1_Paint(System::Object ^ sender,
      System::Windows::Forms::PaintEventArgs ^ pe)
   {
      // Declares the Graphics object and sets it to the Graphics object
      // supplied in the PaintEventArgs.
      Graphics ^ g = pe->Graphics;
      // Insert code to paint the form here.
   }

Método CreateGraphics

Você também pode usar o CreateGraphics método de um controle ou formulário para obter uma referência a um Graphics objeto que representa a superfície de desenho desse controle ou formulário.

Para criar um objeto Graphics com o método CreateGraphics

telefonar the CreateGraphics método do formulário ou controle no qual você deseja processar imagens.

Dim g as Graphics
' Sets g to a Graphics object representing the drawing surface of the
' control or form g is a member of.
g = Me.CreateGraphics

Graphics g;
// Sets g to a graphics object representing the drawing surface of the
// control or form g is a member of.
g = this.CreateGraphics();

Graphics ^ g;
// Sets g to a graphics object representing the drawing surface of the
// control or form g is a member of.
g = this->CreateGraphics();

Criar a partir de um objeto de imagem

Além disso, você pode criar um objeto gráfico de qualquer objeto que deriva do Image classe.

Para criar um objeto Graphics de uma imagem

Chamar o Graphics.FromImage método, fornecendo o nome da variável a imagem da qual você deseja criar um Graphics objeto.

O exemplo a seguir mostra como usar um Bitmap objeto:

Dim myBitmap as New Bitmap("C:\Documents and Settings\Joe\Pics\myPic.bmp")
Dim g as Graphics = Graphics.FromImage(myBitmap)

Bitmap myBitmap = new Bitmap(@"C:\Documents and 
   Settings\Joe\Pics\myPic.bmp");
Graphics g = Graphics.FromImage(myBitmap);

Bitmap ^ myBitmap = gcnew
   Bitmap("D:\\Documents and Settings\\Joe\\Pics\\myPic.bmp");
Graphics ^ g = Graphics::FromImage(myBitmap);

Observação:
Você só pode criar Graphics objetos de arquivos não indexados .bmp, tais sistema autônomo arquivos .bmp 24 bit, 32 bit e 16 bit. Cada pixel de arquivos não indexados .bmp mantém uma cor, em contraste com pixels de arquivos .bmp indexado, que mantêm um índice para uma tabela de cores.

Desenho e manipulando formas e imagens

Depois que ele é criado, um Graphics objeto pode ser usado para desenhar linhas e formas, processar texto, ou exibir e manipular imagens. Os principais objetos que são usados com o Graphics objeto são:

The Pen classe — usados para desenhar linhas, formas de estrutura de tópicos ou outras representações geométricas de renderização.
The Brush classe — usado para preencher sistema autônomo áreas de elementos gráficos, sistema autônomo texto, imagens ou formas preenchidas.
The Font classe — fornece uma descrição de quais formas para usar ao renderização de texto.
The Color estrutura — representa as cores diferentes para exibir.

Usar o objeto gráfico que você criou

Trabalhar com o objeto apropriado listado acima para desenhar o que você precisa.

Para obter mais informações, consulte os seguintes tópicos:

Para processar	Consulte
Linhas	Como: Desenhar uma linha em um formulário do Windows
Shapes	Como: Desenhar uma forma de contornada
Texto	Como: Desenhar texto em um formulário do Windows
Imagens	Como: Processar imagens com GDI +