ImageList.ImageCollection.Add Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute l’objet spécifié à ImageList.

Surcharges

Add(Icon)	Ajoute l'icône spécifiée à ImageList.
Add(Image)	Ajoute l'image spécifiée à ImageList.
Add(Image, Color)	Ajoute l'image spécifiée à ImageList, en utilisant la couleur spécifiée pour générer le masque.
Add(String, Icon)	Ajoute une icône avec la clé spécifiée à la fin de la collection.
Add(String, Image)	Ajoute une image avec la clé spécifiée à la fin de la collection.

Add(Icon)

Ajoute l'icône spécifiée à ImageList.

public:
 void Add(System::Drawing::Icon ^ value);

public void Add (System.Drawing.Icon value);

member this.Add : System.Drawing.Icon -> unit

Public Sub Add (value As Icon)

Paramètres

value: Icon

Icon à ajouter à la liste.

Exceptions

ArgumentNullException

value a la valeur null.

ou - la valeur n'est pas Icon.

Exemples

L’exemple de code suivant illustre la construction d’une , l’ajout d’images ImageListà la Images propriété, la définition de la ImageSize propriété et l’utilisation de la Draw méthode. Pour exécuter cet exemple, placez-le dans un formulaire qui contient un bouton nommé Button1. L’exemple suppose l’existence de FeatherTexture.bmp et gone Fishing.bmp à c:\Windows\. Modifiez l’exemple en conséquence si les bitmaps n’existent pas sur votre système ou existent à un autre emplacement.

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 Icon valeur est convertie en une Bitmap valeur avant d’être ajoutée à la liste.

S’applique à

Add(Image)

Ajoute l'image spécifiée à ImageList.

public:
 void Add(System::Drawing::Image ^ value);

public void Add (System.Drawing.Image value);

member this.Add : System.Drawing.Image -> unit

Public Sub Add (value As Image)

Paramètres

value: Image

Bitmap de l'image à ajouter à la liste.

Exceptions

ArgumentNullException

L'image ajoutée est null.

ArgumentException

L'image ajoutée n'est pas Bitmap.

S’applique à

Add(Image, Color)

Ajoute l'image spécifiée à ImageList, en utilisant la couleur spécifiée pour générer le masque.

public:
 int Add(System::Drawing::Image ^ value, System::Drawing::Color transparentColor);

public int Add (System.Drawing.Image value, System.Drawing.Color transparentColor);

member this.Add : System.Drawing.Image * System.Drawing.Color -> int

Public Function Add (value As Image, transparentColor As Color) As Integer

Paramètres

value: Image

Bitmap de l'image à ajouter à la liste.

transparentColor: Color

Color pour masquer cette image.

Retours

Int32

Index de la nouvelle image ajoutée ou -1 si l'image n'a pas pu être ajoutée.

Exceptions

ArgumentNullException

L'image ajoutée est null.

ArgumentException

L'image ajoutée n'est pas Bitmap.

S’applique à

Add(String, Icon)

Ajoute une icône avec la clé spécifiée à la fin de la collection.

public:
 void Add(System::String ^ key, System::Drawing::Icon ^ icon);

public void Add (string key, System.Drawing.Icon icon);

member this.Add : string * System.Drawing.Icon -> unit

Public Sub Add (key As String, icon As Icon)

Paramètres

key: String

Nom de l'icône.

icon: Icon

Objet Icon à ajouter à la collection.

Exceptions

ArgumentNullException

icon a la valeur null.

Remarques

Le nom d’une image correspond à sa clé dans le ImageList.ImageCollection. Une clé d’image ne respecte pas la casse.

S’applique à

Add(String, Image)

Ajoute une image avec la clé spécifiée à la fin de la collection.

public:
 void Add(System::String ^ key, System::Drawing::Image ^ image);

public void Add (string key, System.Drawing.Image image);

member this.Add : string * System.Drawing.Image -> unit

Public Sub Add (key As String, image As Image)

Paramètres

key: String

Nom de l'image.

image: Image

Objet Image à ajouter à la collection.

Exceptions

ArgumentNullException

image a la valeur null.

Remarques

Le nom d’une image correspond à sa clé dans le ImageList.ImageCollection. Une clé d’image ne respecte pas la casse.

S’applique à

ImageList.ImageCollection.Add Méthode

Définition

Surcharges

Add(Icon)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

Add(Image)

Paramètres

Exceptions

S’applique à

Add(Image, Color)

Paramètres

Retours

Exceptions

S’applique à

Add(String, Icon)

Paramètres

Exceptions

Remarques

S’applique à

Add(String, Image)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires