ImageList.Draw Method (Graphics, Point, Int32)

 

Draws the image indicated by the specified index on the specified Graphics at the given location.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void Draw(
	Graphics g,
	Point pt,
	int index
)

Parameters

g
Type: System.Drawing.Graphics

The Graphics to draw on.

pt
Type: System.Drawing.Point

The location defined by a Point at which to draw the image.

index
Type: System.Int32

The index of the image in the ImageList to draw.

Exception Condition
ArgumentOutOfRangeException

The index is less than 0.

-or-

The index is greater than or equal to the count of images in the image list.

The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. To run this example, place it in a form containing a button named Button1. The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. Change the example accordingly if the bitmaps do not exist on your system, or exist at another location.

internal System.Windows.Forms.ImageList ImageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void Button1_Click(System.Object sender, 
	System.EventArgs e)
{

	// Construct the ImageList.
	ImageList1 = new ImageList();

	// Set the ImageSize property to a larger size 
	// (the default is 16 x 16).
	ImageList1.ImageSize = new Size(112, 112);

	// Add two images to the list.
	ImageList1.Images.Add(
		Image.FromFile("c:\\windows\\FeatherTexture.bmp"));
	ImageList1.Images.Add(
		Image.FromFile("C:\\windows\\Gone Fishing.bmp"));

	// Get a Graphics object from the form's handle.
	Graphics theGraphics = Graphics.FromHwnd(this.Handle);

	// Loop through the images in the list, drawing each image.
	for(int count = 0; count < ImageList1.Images.Count; count++)
	{
		ImageList1.Draw(theGraphics, new Point(85, 85), count);

		// Call Application.DoEvents to force a repaint of the form.
		Application.DoEvents();

		// Call the Sleep method to allow the user to see the image.
		System.Threading.Thread.Sleep(1000);
	}
}

.NET Framework
Available since 1.1
Return to top
Show: