Graphics.FromImage(Image) Método

Definição

Espaço de Nomes:
System.Drawing
Assemblagem:
System.Drawing.dll

Cria um novo Graphics a partir do especificado Image.

public:
 static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);
public static System.Drawing.Graphics FromImage(System.Drawing.Image image);
static member FromImage : System.Drawing.Image -> System.Drawing.Graphics
Public Shared Function FromImage (image As Image) As Graphics

Parâmetros

image
Image

Image a partir da qual criar o novo Graphics.

Devoluções

Graphics

Este método retorna um novo Graphics para o especificado Image.

Exceções

ArgumentNullException

image é null.

Exception

image tem um formato de píxel indexado ou o seu formato é indefinido.

Exemplos

O seguinte exemplo de código foi concebido para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do tratador de eventos Paint. O código executa a seguinte ação:

  • Cria um Image a partir de um ficheiro gráfico SampImag.jpg na pasta de exemplo.

  • Cria um Graphics a partir do Image.

  • Altera a imagem preenchendo um retângulo dentro dela.

  • Desenha-os Image para o ecrã.

  • Liberta o .Graphics

public:
   void FromImageImage( PaintEventArgs^ e )
   {
      // Create image.
      Image^ imageFile = Image::FromFile( "SampImag.jpg" );

      // Create graphics object for alteration.
      Graphics^ newGraphics = Graphics::FromImage( imageFile );

      // Alter image.
      newGraphics->FillRectangle( gcnew SolidBrush( Color::Black ), 100, 50, 100, 100 );

      // Draw image to screen.
      e->Graphics->DrawImage( imageFile, PointF(0.0F,0.0F) );

      // Dispose of graphics object.
      delete newGraphics;
   }

private void FromImageImage(PaintEventArgs e)
{

    // Create image.
    Image imageFile = Image.FromFile("SampImag.jpg");

    // Create graphics object for alteration.
    Graphics newGraphics = Graphics.FromImage(imageFile);

    // Alter image.
    newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100);

    // Draw image to screen.
    e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F));

    // Dispose of graphics object.
    newGraphics.Dispose();
}

Private Sub FromImageImage2(ByVal e As PaintEventArgs)

    ' Create image.
    Dim imageFile As Image = Image.FromFile("SampImag.jpg")

    ' Create graphics object for alteration.
    Dim newGraphics As Graphics = Graphics.FromImage(imageFile)

    ' Alter image.
    newGraphics.FillRectangle(New SolidBrush(Color.Black), _
    100, 50, 100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(imageFile, New PointF(0.0F, 0.0F))

    ' Dispose of graphics object.
    newGraphics.Dispose()
End Sub

Observações

Se a imagem tiver um formato de píxel indexado, este método lança uma exceção com a mensagem, "Um objeto Gráficos não pode ser criado a partir de uma imagem que tenha um formato de píxel indexado." Os formatos de píxeis indexados são mostrados na lista seguinte.

Pode guardar a imagem indexada noutro formato usando o Save(String, ImageFormat) método e depois recuperar um Graphics objeto para a nova imagem.

Este método também lança uma exceção se a imagem tiver algum dos seguintes formatos de píxeis.

Deve sempre chamar o Dispose método para libertar os Graphics recursos relacionados criados pelo FromImage método.

Aplica-se a

Ver também