ImageList.ImageCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Belirtilen nesneyi öğesine ImageListekler.

Aşırı Yüklemeler

Add(Icon)	Belirtilen simgeyi öğesine ImageListekler.
Add(Image)	Belirtilen görüntüyü öğesine ImageListekler.
Add(Image, Color)	Maskeyi oluşturmak için ImageListbelirtilen rengi kullanarak belirtilen görüntüyü öğesine ekler.
Add(String, Icon)	Koleksiyonun sonuna belirtilen anahtarı içeren bir simge ekler.
Add(String, Image)	Koleksiyonun sonuna belirtilen anahtara sahip bir görüntü ekler.

Add(Icon)

Belirtilen simgeyi öğesine ImageListekler.

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)

Parametreler

value

Icon

Listeye eklemek için bir Icon .

Özel durumlar

ArgumentNullException

valuenull

-veya- değeri bir Icondeğildir.

Örnekler

Aşağıdaki kod örneği, oluşturma ImageListişlemini, özelliğine Images görüntü eklemeyi, özelliği ayarlamayı ImageSize ve yöntemini kullanmayı Draw gösterir. Bu örneği çalıştırmak için, adlı düğmeyi Button1içeren bir forma yerleştirin. Örnekte c:\\Windows konumunda FeatherTexture.bmp ve Gone Fishing.bmp olduğu varsayılır. Bit eşlemler sisteminizde yoksa veya başka bir konumda mevcutsa, örneği buna göre değiştirin.

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

Açıklamalar

Icon, listeye eklenmeden önce öğesine Bitmap dönüştürülür.

Add(Image)

Belirtilen görüntüyü öğesine ImageListekler.

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)

Parametreler

value

Image

Bitmap Listeye eklenecek görüntünün bir bölümü.

Özel durumlar

ArgumentNullException

Eklenen görüntü şeklindedir null.

ArgumentException

Eklenen görüntü bir Bitmapdeğil.

Add(Image, Color)

Maskeyi oluşturmak için ImageListbelirtilen rengi kullanarak belirtilen görüntüyü öğesine ekler.

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

Parametreler

value

Image

Bitmap Listeye eklenecek görüntünün bir bölümü.

transparentColor

Color

Color Bu görüntüyü maskele.

Döndürülenler

Int32

Yeni eklenen görüntünün dizini veya görüntü eklenemediğinde -1.

Özel durumlar

ArgumentNullException

Eklenen görüntü şeklindedir null.

ArgumentException

Eklenen görüntü bir Bitmapdeğil.

Add(String, Icon)

Koleksiyonun sonuna belirtilen anahtarı içeren bir simge ekler.

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)

Parametreler

key

String

Simgenin adı.

icon

Icon

Icon koleksiyonuna eklenecek öğesini seçin.

Özel durumlar

ArgumentNullException

icon, null değeridir.

Açıklamalar

Görüntünün adı içindeki anahtarına ImageList.ImageCollectionkarşılık gelir. Görüntü anahtarı büyük/küçük harfe duyarlı değildir.

Add(String, Image)

Koleksiyonun sonuna belirtilen anahtara sahip bir görüntü ekler.

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)

Parametreler

key

String

Görüntünün adı.

image

Image

Image koleksiyonuna eklenecek öğesini seçin.

Özel durumlar

ArgumentNullException

image, null değeridir.

Açıklamalar

Görüntünün adı içindeki anahtarına ImageList.ImageCollectionkarşılık gelir. Görüntü anahtarı büyük/küçük harfe duyarlı değildir.