How to: Render Images with GDI+

You can use GDI+ to render images that exist as files in your applications. You do this by creating a new object of an Image class (such as Bitmap), creating a Graphics object that refers to the drawing surface you want to use, and calling the DrawImage method of the Graphics object. The image will be painted onto the drawing surface represented by the graphics class. You can use the Image Editor to create and edit image files at design time, and render them with GDI+ at run time. For more information, see Image Editor for Icons.

1. Create an object representing the image you want to display. This object must be a member of a class that inherits from Image, such as Bitmap or Metafile. An example is shown:

   // Uses the System.Environment.GetFolderPath to get the path to the
   // current user's MyPictures folder.  
   Bitmap myBitmap = new Bitmap  
      (System.Environment.GetFolderPath  
         (System.Environment.SpecialFolder.MyPictures));  
   

2. Create a Graphics object that represents the drawing surface you want to use. For more information, see How to: Create Graphics Objects for Drawing.

   // Creates a Graphics object that represents the drawing surface of
   // Button1.  
   Graphics g = Button1.CreateGraphics();  
   

3. Call the DrawImage of your graphics object to render the image. You must specify both the image to be drawn, and the coordinates where it is to be drawn.

   g.DrawImage(myBitmap, 1, 1);  
   

• Getting Started with Graphics Programming
• How to: Create Graphics Objects for Drawing
• Pens, Lines, and Rectangles in GDI+
• How to: Draw Text on a Windows Form
• Graphics and Drawing in Windows Forms
• Drawing Lines or Closed Figures
• Image Editor for Icons