ImageList Constructores

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Inicializa una nueva instancia de la clase ImageList.

Sobrecargas

ImageList()	Inicializa una nueva instancia de la clase ImageList con valores predeterminados para ColorDepth, ImageSize y TransparentColor.
ImageList(IContainer)	Inicializa una nueva instancia de la clase ImageList asociándola a un contenedor.

ImageList()

Inicializa una nueva instancia de la clase ImageList con valores predeterminados para ColorDepth, ImageSize y TransparentColor.

public:
 ImageList();

public ImageList ();

Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir , ImageListagregar imágenes a la Images propiedad , establecer la ImageSize propiedad y usar 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

En la tabla siguiente se muestran los valores de propiedad iniciales de una instancia de ImageList.

Elemento	Descripción
ColorDepth	En las versiones de .NET Framework y .NET (Core) a través de .NET 7, el valor predeterminado es Depth8Bit. En .NET 8 y versiones posteriores, el valor predeterminado es Depth32Bit.
ImageSize	El valor predeterminado es un Size objeto con un alto y ancho de 16 por 16.
TransparentColor	El valor predeterminado es Transparent.

ImageList(IContainer)

Inicializa una nueva instancia de la clase ImageList asociándola a un contenedor.

public:
 ImageList(System::ComponentModel::IContainer ^ container);

public ImageList (System.ComponentModel.IContainer container);

new System.Windows.Forms.ImageList : System.ComponentModel.IContainer -> System.Windows.Forms.ImageList

Public Sub New (container As IContainer)

Parámetros

container

IContainer

Objeto que implementa IContainer para asociarse con esta instancia de ImageList.

Comentarios

El ImageList constructor permite asociar un ImageList objeto a cualquier Container objeto . Al asociar como ImageList este, se pasa el control de la duración de ImageList a .Container Esto puede ser útil si usa una serie de componentes en la aplicación y desea eliminarlos simultáneamente. Por ejemplo, si asocia un ToolTip, y ImageLista con un ContainerTimer elemento , al llamar Dispose a en el contenedor también forzará la eliminación de todos estos componentes.