ImageList.ImageSize Propriété

Définition

Obtient ou définit la taille des images dans la liste d'images.Gets or sets the size of the images in the image list.

public:
 property System::Drawing::Size ImageSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size ImageSize { get; set; }
member this.ImageSize : System.Drawing.Size with get, set
Public Property ImageSize As Size

Valeur de propriété

Size

Size définit, en pixels, la hauteur et la largeur des images dans la liste.The Size that defines the height and width, in pixels, of the images in the list. La taille par défaut est 16 par 16.The default size is 16 by 16. La taille maximale 256 par 256.The maximum size is 256 by 256.

Exceptions

La valeur assignée est égale à IsEmpty.The value assigned is equal to IsEmpty.

-ou--or- La hauteur ou la largeur est inférieure ou égale à zéro.The value of the height or width is less than or equal to 0.

-ou--or- La hauteur ou la largeur est supérieure à 256.The value of the height or width is greater than 256.

La nouvelle taille est inférieure à 0 ou supérieure à 256.The new size has a dimension less than 0 or greater than 256.

Exemples

L’exemple de code suivant illustre la construction d’un ImageList , l’ajout d’images à la Images propriété, la définition de la ImageSize propriété et l’utilisation de la Draw méthode.The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. Pour exécuter cet exemple, placez-le dans un formulaire contenant un bouton nommé Button1 .To run this example, place it in a form containing a button named Button1. L’exemple suppose l’existence de FeatherTexture.bmp et Gone Fishing.bmp à c:\Windows \ .The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. Modifiez l’exemple en conséquence si les bitmaps n’existent pas sur votre système ou existent à un autre emplacement.Change the example accordingly if the bitmaps do not exist on your system, or exist at another location.

internal:
   System::Windows::Forms::ImageList^ ImageList1;

private:

   // Create an ImageList Object, populate it, and display
   // the images it contains.
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Construct the ImageList.
      ImageList1 = gcnew ImageList;
      
      // Set the ImageSize property to a larger size 
      // (the default is 16 x 16).
      ImageList1->ImageSize = System::Drawing::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, 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 );

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

Friend WithEvents ImageList1 As System.Windows.Forms.ImageList

' Create an ImageList Object, populate it, and display
' the images it contains.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' 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"))

    Dim count As System.Int32

    ' Get a Graphics object from the form's handle.
    Dim theGraphics As Graphics = Graphics.FromHwnd(Me.Handle)

    ' Loop through the images in the list, drawing each image.
    For count = 0 To ImageList1.Images.Count - 1
        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)
    Next
End Sub

Remarques

La définition de la ImageSize propriété avant l’ajout d’images à la collection d’images entraîne le redimensionnement des images à la taille d’image spécifiée.Setting the ImageSize property prior to adding images to the image collection causes the images to be resized to the image size specified.

Lorsque vous affectez ImageSize une nouvelle valeur à la propriété, le Handle pour la liste d’images est recréé.When you set the ImageSize property to a new value, the Handle for the image list is recreated.

Étant donné que la définition de la ImageSize propriété entraîne la recréation du handle, vous devez définir ImageSize avant de définir la Images propriété.Because setting the ImageSize property causes the handle to be recreated, you should set ImageSize prior to setting the Images property. Lorsque le handle de ImageList a été créé, la définition ColorDepth ImageSize des propriétés ou dans le code, après la définition de la Images propriété, entraîne la suppression de la collection d’images définie pour la Images propriété.When the handle for the ImageList has been created, setting the ColorDepth or ImageSize properties in code, after setting the Images property, will cause the collection of images set for the Images property to be deleted.

S’applique à