ImageList Costruttori

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Inizializza una nuova istanza della classe ImageList.

Overload

Nome	Descrizione
ImageList()	Inizializza una nuova istanza della ImageList classe con valori predefiniti per ColorDepth, ImageSizee TransparentColor.
ImageList(IContainer)	Inizializza una nuova istanza della ImageList classe , associandola a un contenitore.

ImageList()

Origine:

ImageList.cs

Inizializza una nuova istanza della ImageList classe con valori predefiniti per ColorDepth, ImageSizee TransparentColor.

public:
 ImageList();

public ImageList();

Public Sub New ()

Esempio

L'esempio di codice seguente illustra la creazione di un oggetto ImageList, l'aggiunta Images di immagini alla 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

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ImageList.

Elemento	Descrizione
ColorDepth	Nelle versioni di .NET Framework e .NET (Core) fino a .NET 7, il valore predefinito è Depth8Bit. In .NET 8 e versioni successive il valore predefinito è Depth32Bit.
ImageSize	Il valore predefinito è un Size oggetto con altezza e larghezza di 16 per 16.
TransparentColor	Il valore predefinito è Transparent.

ImageList(IContainer)

Origine:

ImageList.cs

Inizializza una nuova istanza della ImageList classe , associandola a un contenitore.

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)

Parametri

container

IContainer

Oggetto che implementa IContainer per l'associazione a questa istanza di ImageList.

Commenti

Il ImageList costruttore consente di associare un oggetto ImageList a qualsiasi Container oggetto . Associando l'oggetto ImageList in questo modo, si passa al controllo della durata dell'oggetto ContainerImageList a . Ciò può essere utile se si usano diversi componenti nell'applicazione e si vuole eliminarli contemporaneamente. Ad esempio, se si associa un ToolTipoggetto , un ImageListoggetto e a un ContainerTimer oggetto , la chiamata Dispose al contenitore forza l'eliminazione di tutti questi componenti.