Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ImageList Constructor
Collapse the table of content
Expand the table of content

ImageList Constructor

Initializes a new instance of the ImageList class with default values for ColorDepth, ImageSize, and TransparentColor.

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

public ImageList()

The following table shows initial property values for an instance of ImageList.

Item

Description

ColorDepth

In the .NET Framework version 1.0, the default is Depth4Bit. In the .NET Framework version 1.1 or later, the default is Depth8Bit.

ImageSize

The default is a Size object with a height and width of 16 by 16.

TransparentColor

The default value is Transparent.

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);
		}
	}
setting the ImageSize property and the use of the Draw method.  

To run this sample place it in a form containing a button named Button1.  
The sample assumes the existence of FeatherTexture.bmp and
Gone Fishing.bmp at c:\Windows\. Change the sample accordingly if the

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft