Graphics.FromImage(Image) Graphics.FromImage(Image) Graphics.FromImage(Image) Method

Definición

Crea un nuevo Graphics con la Image especificada.Creates a new Graphics from the specified 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

Parámetros

image
Image Image Image

Image a partir de la cual se va a crear el nuevo Graphics.Image from which to create the new Graphics.

Devoluciones

Este método devuelve un nuevo objeto Graphics para la Image especificada.This method returns a new Graphics for the specified Image.

Excepciones

image tiene un formato de píxel indizado o su formato no está definido.image has an indexed pixel format or its format is undefined.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código realiza la acción siguiente:The code performs the following action:

  • Crea un Image a partir de un archivo de gráficos SampImag. jpg en la carpeta de ejemplo.Creates an Image from a graphics file SampImag.jpg in the example folder.

  • Crea un Graphics a Imagepartir de.Creates a Graphics from the Image.

  • Modifica la imagen rellenando un rectángulo dentro de ella.Alters the image by filling a rectangle within it.

  • Image Dibuja en la pantalla.Draws the Image to the screen.

  • Libera el creado Graphics.Releases the created 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

Comentarios

Si la imagen tiene un formato de píxel indizado, este método produce una excepción con el mensaje "no se puede crear un objeto de gráficos a partir de una imagen que tenga un formato de píxel indizado".If the image has an indexed pixel format, this method throws an exception with the message, "A Graphics object cannot be created from an image that has an indexed pixel format." Los formatos de píxel indexados se muestran en la lista siguiente.The indexed pixel formats are shown in the following list.

Puede guardar la imagen indizada como otro formato usando el Save(String, ImageFormat) método y, a continuación, recuperar un Graphics objeto para la nueva imagen.You can save the indexed image as another format by using the Save(String, ImageFormat) method and then retrieve a Graphics object for the new image.

Este método también produce una excepción si la imagen tiene cualquiera de los siguientes formatos de píxel.This method also throws an exception if the image has any of the following pixel formats.

Siempre debe llamar Dispose al método para Graphics liberar y los recursos relacionados creados por el FromImage método.You should always call the Dispose method to release the Graphics and related resources created by the FromImage method.

Se aplica a

Consulte también: