ImageList.ImageCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge l'oggetto specificato all'oggetto ImageList.

Overload

Add(Icon)	Aggiunge l'icona specificata all'oggetto ImageList.
Add(Image)	Aggiunge l'immagine specificata all'oggetto ImageList.
Add(Image, Color)	Aggiunge l'immagine specificata all'oggetto ImageList, utilizzando il colore specificato per generare la maschera.
Add(String, Icon)	Aggiunge un'icona con la chiave specificata alla fine dell'insieme.
Add(String, Image)	Aggiunge un'immagine con la chiave specificata alla fine dell'insieme.

Add(Icon)

Aggiunge l'icona specificata all'oggetto 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)

Parametri

value

Icon

Oggetto Icon da aggiungere all'elenco.

Eccezioni

ArgumentNullException

value è null

-oppure-

il valore non è un oggetto Icon.

Esempio

L'esempio di codice seguente illustra la costruzione di un ImageListoggetto , l'aggiunta di immagini alla Images proprietà, l'impostazione della ImageSize proprietà e l'uso del Draw metodo . Per eseguire questo esempio, inserirlo in un modulo contenente un pulsante denominato Button1. L'esempio presuppone l'esistenza di FeatherTexture.bmp e Gone Fishing.bmp in c:\Windows\. Modificare di conseguenza l'esempio se le bitmap non esistono nel sistema o esistono in un'altra posizione.

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

Commenti

L'oggetto Icon viene convertito in un Bitmap oggetto prima che venga aggiunto all'elenco.

Add(Image)

Aggiunge l'immagine specificata all'oggetto 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)

Parametri

value

Image

Oggetto Bitmap dell'immagine da aggiungere all'elenco.

Eccezioni

ArgumentNullException

L'immagine da aggiungere è null.

ArgumentException

L'immagine da aggiungere non è un oggetto Bitmap.

Add(Image, Color)

Aggiunge l'immagine specificata all'oggetto ImageList, utilizzando il colore specificato per generare la maschera.

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

Parametri

value

Image

Oggetto Bitmap dell'immagine da aggiungere all'elenco.

transparentColor

Color

L'oggetto Color per creare una maschera dell'immagine.

Restituisce

Int32

Indice dell'immagine appena aggiunta oppure -1 se non è possibile aggiungere l'immagine.

Eccezioni

ArgumentNullException

L'immagine da aggiungere è null.

ArgumentException

L'immagine da aggiungere non è un oggetto Bitmap.

Add(String, Icon)

Aggiunge un'icona con la chiave specificata alla fine dell'insieme.

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)

Parametri

key

String

Nome dell'icona.

icon

Icon

Oggetto Icon da aggiungere alla raccolta.

Eccezioni

ArgumentNullException

icon è null.

Commenti

Il nome di un'immagine corrisponde alla chiave in ImageList.ImageCollection. Una chiave immagine non è distinzione tra maiuscole e minuscole.

Add(String, Image)

Aggiunge un'immagine con la chiave specificata alla fine dell'insieme.

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)

Parametri

key

String

Nome dell'immagine.

image

Image

Oggetto Image da aggiungere alla raccolta.

Eccezioni

ArgumentNullException

image è null.

Commenti

Il nome di un'immagine corrisponde alla chiave in ImageList.ImageCollection. Una chiave immagine non è distinzione tra maiuscole e minuscole.