ImageList.ImageCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá zadaný objekt do objektu ImageList.

Přetížení

Name	Description
Add(Icon)	Přidá zadanou ikonu do ikony ImageList.
Add(Image)	Přidá zadaný obrázek do souboru ImageList.
Add(Image, Color)	Přidá zadaný obrázek do objektu ImageList, pomocí zadané barvy vygeneruje masku.
Add(String, Icon)	Přidá na konec kolekce ikonu se zadaným klíčem.
Add(String, Image)	Přidá obrázek se zadaným klíčem na konec kolekce.

Add(Icon)

Zdroj:

ImageList.ImageCollection.cs

Přidá zadanou ikonu do ikony 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)

Parametry

value

Icon

Přidání Icon do seznamu

Výjimky

ArgumentNullException

value je null

nebo

hodnota není Icon.

Příklady

Následující příklad kódu ukazuje vytvoření ImageList, přidání obrázků do Images vlastnosti, nastavení ImageSize vlastnosti a použití Draw metody. Pokud chcete tento příklad spustit, umístěte ho do formuláře, který obsahuje tlačítko s názvem Button1. Příklad předpokládá existenci FeatherTexture.bmp a pryč Fishing.bmp v c:\Windows\. Odpovídajícím způsobem změňte příklad, pokud rastrové obrázky v systému neexistují nebo existují v jiném umístě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

Poznámky

Převede se Icon na před Bitmap jeho přidání do seznamu.

Add(Image)

Zdroj:

ImageList.ImageCollection.cs

Přidá zadaný obrázek do souboru 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)

Parametry

value

Image

Obrázek Bitmap , který chcete přidat do seznamu.

Výjimky

ArgumentNullException

Přidaný obrázek je null.

ArgumentException

Přidaný obrázek není .Bitmap

Add(Image, Color)

Zdroj:

ImageList.ImageCollection.cs

Přidá zadaný obrázek do objektu ImageList, pomocí zadané barvy vygeneruje masku.

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

Parametry

value

Image

Obrázek Bitmap , který chcete přidat do seznamu.

transparentColor

Color

Obrázek Color se maskuje.

Návraty

Int32

Index nově přidané image nebo -1, pokud obrázek nelze přidat.

Výjimky

ArgumentNullException

Přidaný obrázek je null.

ArgumentException

Přidaný obrázek není .Bitmap

Add(String, Icon)

Zdroj:

ImageList.ImageCollection.cs

Přidá na konec kolekce ikonu se zadaným klíčem.

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)

Parametry

key

String

Název ikony

icon

Icon

Přidání Icon do kolekce.

Výjimky

ArgumentNullException

icon je null.

Poznámky

Název obrázku odpovídá jeho klíči v objektu ImageList.ImageCollection. Klíč obrázku nerozlišuje malá a velká písmena.

Add(String, Image)

Zdroj:

ImageList.ImageCollection.cs

Přidá obrázek se zadaným klíčem na konec kolekce.

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)

Parametry

key

String

Název obrázku.

image

Image

Přidání Image do kolekce.

Výjimky

ArgumentNullException

image je null.

Poznámky

Název obrázku odpovídá jeho klíči v objektu ImageList.ImageCollection. Klíč obrázku nerozlišuje malá a velká písmena.