Cette documentation est archivée et n’est pas conservée.

ImageList.ImageSize, propriété

Mise à jour : novembre 2007

Obtient ou définit la taille des images dans la liste d'images.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public Size ImageSize { get; set; }
/** @property */
public Size get_ImageSize()
/** @property */
public  void set_ImageSize(Size value)

public function get ImageSize () : Size
public function set ImageSize (value : Size)

Valeur de propriété

Type : System.Drawing.Size

Size définit, en pixels, la hauteur et la largeur des images dans la liste. La taille par défaut est de 16 x 16. La taille maximale est de 256 x 256.

ExceptionCondition
ArgumentException

La valeur assignée est égale à IsEmpty.

- ou -

La hauteur ou la largeur est inférieure ou égale à zéro.

- ou -

La hauteur ou la largeur est supérieure à 256.

ArgumentOutOfRangeException

La nouvelle taille est inférieure à 0 ou supérieure à 256.

La définition de la propriété ImageSize avant l'ajout d'images à la collection d'images entraîne le redimensionnement des images à la taille d'image spécifiée.

Lorsque vous affectez une nouvelle valeur à la propriété ImageSize, le Handle de la liste d'images est recréé.

Comme la définition de la propriété ImageSize entraîne la recréation du handle, vous devez définir ImageSize avant de définir la propriété Images. Lorsque le handle de ImageList est créé, la définition des propriétés ColorDepth ou ImageSize dans le code, après la définition de la propriété Images, entraîne la suppression de la collection d'images définie pour la propriété Images.

L'exemple de code suivant illustre la construction de ImageList, l'ajout d'images à la propriété Images, la définition de la propriété ImageSize et l'utilisation de la méthode Draw. Pour exécuter cet exemple, placez-le dans un formulaire contenant un bouton nommé Button1. L'exemple suppose l'existence de FeatherTexture.bmp et Gone Fishing.bmp dans c:\Windows\. Changez l'exemple comme si les bitmaps n'existaient pas sur votre système, ou se trouvaient ailleurs.

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



private System.Windows.Forms.ImageList imageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void button1_Click(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.set_ImageSize(new Size(112, 112));
    // Add two images to the list.
    imageList1.get_Images().Add(Image.FromFile(
        "c:\\windows\\FeatherTexture.bmp"));
    imageList1.get_Images().Add(Image.FromFile(
        "C:\\windows\\Gone Fishing.bmp"));
    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.get_Handle());
    // Loop through the images in the list, drawing each image.
    for (int count = 0; count < imageList1.get_Images().get_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);
    }
} //button1_Click


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0
Afficher: