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í

Add(Icon)	Přidá zadanou ikonu do .ImageList
Add(Image)	Přidá zadanou image do .ImageList
Add(Image, Color)	Přidá zadaný obrázek do objektu ImageListpomocí zadané barvy, aby se vygenerovala maska.
Add(String, Icon)	Přidá ikonu se zadaným klíčem na konec kolekce.
Add(String, Image)	Přidá image se zadaným klíčem na konec kolekce.

Add(Icon)

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

Chcete-li Icon přidat do seznamu.

Výjimky

ArgumentNullException

value je null

-nebo-

value 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 gone Fishing.bmp v c:\Windows\. Změňte příklad odpovídajícím způsobem, pokud rastrové obrázky neexistují v systému nebo existují na jiném místě.

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řed tím, Icon než se přidá do seznamu, se převede Bitmap na .

Add(Image)

Přidá zadanou image do .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

A Bitmap obrázku, který chcete přidat do seznamu.

Výjimky

ArgumentNullException

Přidává se nullimage .

ArgumentException

Přidaná image není .Bitmap

Add(Image, Color)

Přidá zadaný obrázek do objektu ImageListpomocí zadané barvy, aby se vygenerovala maska.

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

A Bitmap obrázku, který chcete přidat do seznamu.

transparentColor

Color

K Color maskování tohoto obrázku.

Návraty

Int32

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

Výjimky

ArgumentNullException

Přidává se nullimage .

ArgumentException

Přidaná image není .Bitmap

Add(String, Icon)

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

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á Icon se do kolekce.

Výjimky

ArgumentNullException

icon je null.

Poznámky

Název image odpovídá jeho klíči v objektu ImageList.ImageCollection. V klíči image se nerozlišuje velká a malá písmena.

Add(String, Image)

Přidá image 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 image.

image

Image

Přidá Image se do kolekce.

Výjimky

ArgumentNullException

image je null.

Poznámky

Název image odpovídá jeho klíči v objektu ImageList.ImageCollection. V klíči image se nerozlišuje velká a malá písmena.