Export (0) Print
Expand All
3 out of 4 rated this helpful - Rate this topic

Graphics.FromImage Method

Creates a new Graphics from the specified Image.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

public static Graphics FromImage (
	Image image
)
public static Graphics FromImage (
	Image image
)
public static function FromImage (
	image : Image
) : Graphics
Not applicable.

Parameters

image

Image from which to create the new Graphics.

Return Value

This method returns a new Graphics for the specified Image.
Exception typeCondition

ArgumentNullException

image is a null reference (Nothing in Visual Basic).

Exception

image has an indexed pixel format or its format is undefined.

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." The indexed pixel formats are shown in the following list.

This method also throws an exception if the image has any of the following pixel formats.

You should always call the Dispose method to release the Graphics and related resources created by the FromImage method.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following action:

  • Creates an Image from a graphics file SampImag.jpg in the example folder.

  • Creates a Graphics from the Image.

  • Alters the image by filling a rectangle within it.

  • Draws the Image to the screen.

  • Releases the created Graphics.

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();
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.