ImageList.ImageCollection.Add Metod

Definition

Namnområde:: System.Windows.Forms

Sammansättning:: System.Windows.Forms.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till det angivna objektet i ImageList.

Överlagringar

Name	Description
Add(Icon)	Lägger till den angivna ikonen i ImageList.
Add(Image)	Lägger till den angivna bilden i ImageList.
Add(Image, Color)	Lägger till den angivna bilden i ImageList, med den angivna färgen för att generera masken.
Add(String, Icon)	Lägger till en ikon med den angivna nyckeln i slutet av samlingen.
Add(String, Image)	Lägger till en bild med den angivna nyckeln i slutet av samlingen.

Add(Icon)

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Lägger till den angivna ikonen i 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)

Parametrar

value: Icon

En Icon som ska läggas till i listan.

Undantag

ArgumentNullException

value är null

-eller-

värdet är inte en Icon.

Exempel

Följande kodexempel visar hur du skapar en ImageList, lägger till bilder i Images egenskapen, anger ImageSize egenskapen och använder Draw metoden. Om du vill köra det här exemplet placerar du det i ett formulär som innehåller en knapp med namnet Button1. Exemplet förutsätter att det finns FeatherTexture.bmp och Gone Fishing.bmp på c:\Windows\. Ändra exemplet om bitmapparna inte finns i systemet eller finns på en annan plats.

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

Kommentarer

Icon Konverteras till en Bitmap innan den läggs till i listan.

Gäller för

Add(Image)

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Lägger till den angivna bilden i 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)

Parametrar

value: Image

En Bitmap av de bilder som ska läggas till i listan.

Undantag

ArgumentNullException

Bilden som läggs till är null.

ArgumentException

Bilden som läggs till är inte en Bitmap.

Gäller för

Add(Image, Color)

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Lägger till den angivna bilden i ImageList, med den angivna färgen för att generera masken.

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

Parametrar

value: Image

En Bitmap av de bilder som ska läggas till i listan.

transparentColor: Color

Att Color maskera den här bilden.

Returer

Int32

Indexet för den nyligen tillagda bilden eller -1 om bilden inte kan läggas till.

Undantag

ArgumentNullException

Bilden som läggs till är null.

ArgumentException

Bilden som läggs till är inte en Bitmap.

Gäller för

Add(String, Icon)

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Lägger till en ikon med den angivna nyckeln i slutet av samlingen.

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)

Parametrar

key: String

Namnet på ikonen.

icon: Icon

Att Icon lägga till i samlingen.

Undantag

ArgumentNullException

icon är null.

Kommentarer

Namnet på en bild motsvarar dess nyckel i ImageList.ImageCollection. En bildnyckel är inte skiftlägeskänslig.

Gäller för

Add(String, Image)

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Källa:: ImageList.ImageCollection.cs

Lägger till en bild med den angivna nyckeln i slutet av samlingen.

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)

Parametrar

key: String

Namnet på avbildningen.

image: Image

Att Image lägga till i samlingen.

Undantag

ArgumentNullException

image är null.

Kommentarer

Namnet på en bild motsvarar dess nyckel i ImageList.ImageCollection. En bildnyckel är inte skiftlägeskänslig.

Gäller för

Feedback

Var den här sidan till hjälp?