Export (0) Print
Expand All

ImageList.Images Property

Gets the ImageList.ImageCollection for this image list.

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

public ImageList.ImageCollection Images { get; }

Property Value

Type: System.Windows.Forms.ImageList.ImageCollection
The collection of images.

If the image collection has not yet been created, it is created when you retrieve this property.

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.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft