ImageList.ImageCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega el objeto especificado a .ImageList

Sobrecargas

Nombre	Description
Add(Icon)	Agrega el icono especificado a .ImageList
Add(Image)	Agrega la imagen especificada a .ImageList
Add(Image, Color)	Agrega la imagen especificada a , ImageListutilizando el color especificado para generar la máscara.
Add(String, Icon)	Agrega un icono con la clave especificada al final de la colección.
Add(String, Image)	Agrega una imagen con la clave especificada al final de la colección.

Add(Icon)

Source:

ImageList.ImageCollection.cs

Agrega el icono especificado a .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)

Parámetros

value

Icon

que Icon se va a agregar a la lista.

Excepciones

ArgumentNullException

value es null.

O bien

value no es .Icon

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un ImageList, agregando imágenes a la Images propiedad , estableciendo la ImageSize propiedad y usando el Draw método . Para ejecutar este ejemplo, colóquelo en un formulario que contenga un botón denominado Button1. En el ejemplo se supone la existencia de FeatherTexture.bmp y Gone Fishing.bmp en c:\Windows\. Cambie el ejemplo en consecuencia si los mapas de bits no existen en el sistema o existen en otra ubicación.

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

Comentarios

Icon se convierte en un Bitmap antes de agregarlo a la lista.

Add(Image)

Source:

ImageList.ImageCollection.cs

Agrega la imagen especificada a .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)

Parámetros

value

Image

de Bitmap la imagen que se va a agregar a la lista.

Excepciones

ArgumentNullException

La imagen que se va a agregar es null.

ArgumentException

La imagen que se agrega no es .Bitmap

Add(Image, Color)

Source:

ImageList.ImageCollection.cs

Agrega la imagen especificada a , ImageListutilizando el color especificado para generar la máscara.

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

Parámetros

value

Image

de Bitmap la imagen que se va a agregar a la lista.

transparentColor

Color

que Color se va a enmascarar esta imagen.

Devoluciones

Int32

Índice de la imagen recién agregada o -1 si no se puede agregar la imagen.

Excepciones

ArgumentNullException

La imagen que se va a agregar es null.

ArgumentException

La imagen que se agrega no es .Bitmap

Add(String, Icon)

Source:

ImageList.ImageCollection.cs

Agrega un icono con la clave especificada al final de la colección.

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)

Parámetros

key

String

Nombre del icono.

icon

Icon

que Icon se va a agregar a la colección.

Excepciones

ArgumentNullException

icon es null.

Comentarios

El nombre de una imagen corresponde a su clave en .ImageList.ImageCollection Una clave de imagen no distingue mayúsculas de minúsculas.

Add(String, Image)

Source:

ImageList.ImageCollection.cs

Agrega una imagen con la clave especificada al final de la colección.

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)

Parámetros

key

String

Nombre de la imagen.

image

Image

que Image se va a agregar a la colección.

Excepciones

ArgumentNullException

image es null.

Comentarios

El nombre de una imagen corresponde a su clave en .ImageList.ImageCollection Una clave de imagen no distingue mayúsculas de minúsculas.