Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ImageList.ImageCollection-Klasse

Kapselt die Auflistung von Image-Objekten in eine ImageList.

System.Object
  System.Windows.Forms.ImageList.ImageCollection

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
public sealed class ImageCollection : IList, 
	ICollection, IEnumerable

Der ImageList.ImageCollection-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche EigenschaftCountRuft die Anzahl der derzeit in der Liste vorhandenen Bilder ab.
Öffentliche EigenschaftEmptyRuft einen Wert ab, der angibt, ob ImageList Bilder enthält.
Öffentliche EigenschaftIsReadOnlyRuft einen Wert ab, der angibt, ob die Liste schreibgeschützt ist.
Öffentliche EigenschaftItem[Int32]Ruft ein Image am angegebenen Index in der Auflistung ab oder legt dieses fest.
Öffentliche EigenschaftItem[String]Ruft ein Image mit dem angegebenen Schlüssel aus der Auflistung ab.
Öffentliche EigenschaftKeysRuft die Auflistung von Schlüsseln ab, die den Bildern in der ImageList.ImageCollection zugeordnet sind.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeAdd(Icon)Fügt ImageList das angegebene Symbol hinzu.
Öffentliche MethodeAdd(Image)Fügt ImageList das angegebene Bild hinzu.
Öffentliche MethodeAdd(Image, Color)Fügt ImageList das angegebene Bild hinzu, wobei zum Generieren der Maske die angegebene Farbe verwendet wird.
Öffentliche MethodeAdd(String, Icon)Fügt ein Symbol mit dem angegebenen Schlüssel am Ende der Auflistung hinzu.
Öffentliche MethodeAdd(String, Image)Fügt ein Bild mit dem angegebenen Schlüssel am Ende der Auflistung hinzu.
Öffentliche MethodeAddRangeFügt der Auflistung ein Array von Bildern hinzu.
Öffentliche MethodeAddStripFügt der ImageList einen Bildstreifen des angegebenen Bildes hinzu.
Öffentliche MethodeClearEntfernt alle Bilder und Masken aus ImageList.
Öffentliche MethodeContainsWird nicht unterstützt. Mit der IList.Contains-Methode wird angegeben, ob ein angegebenes Objekt in der Liste enthalten ist.
Öffentliche MethodeContainsKeyBestimmt, ob die Auflistung ein Bild mit dem angegebenen Schlüssel enthält.
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Öffentliche MethodeGetEnumeratorGibt einen Enumerator zurück, der zum Durchlaufen der Elementauflistung verwendet werden kann.
Öffentliche MethodeGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIndexOfWird nicht unterstützt. Die IndexOf-Methode gibt den Index eines angegebenen Objekts in der Liste zurück.
Öffentliche MethodeIndexOfKeyBestimmt den Index des ersten Vorkommens eines Bildes mit dem angegebenen Schlüssel in der Auflistung.
Öffentliche MethodeRemoveWird nicht unterstützt. Die IList.Remove-Methode entfernt ein angegebenes Objekt aus der Liste.
Öffentliche MethodeRemoveAtEntfernt ein Bild aus der Liste.
Öffentliche MethodeRemoveByKeyEntfernt das Bild mit dem angegebenen Schlüssel aus der Auflistung.
Öffentliche MethodeSetKeyNameLegt den Schlüssel für ein Bild in der Auflistung fest.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliche ErweiterungsmethodeAsParallelErmöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.)
Öffentliche ErweiterungsmethodeAsQueryableKonvertiert ein IEnumerable in ein IQueryable. (Durch Queryable definiert.)
Öffentliche ErweiterungsmethodeCast<TResult>Wandelt die Elemente eines IEnumerable in den angegebenen Typ um. (Durch Enumerable definiert.)
Öffentliche ErweiterungsmethodeOfType<TResult>Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.)
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeICollection.CopyToInfrastruktur. Kopiert die Elemente in dieser Auflistung in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.IsSynchronizedInfrastruktur. Ruft einen Wert ab, der angibt, ob der Zugriff auf die Auflistung synchronisiert (threadsicher) ist.
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.SyncRootInfrastruktur. Ruft ein Objekt ab, mit dem der Zugriff auf die Auflistung synchronisiert werden kann.
Explizite SchnittstellenimplementierungPrivate MethodeIList.AddInfrastruktur. Fügt ImageList das angegebene Bild hinzu.
Explizite SchnittstellenimplementierungPrivate MethodeIList.ContainsInfrastruktur. Implementiert die Contains-Methode. Löst in allen Fällen eine NotSupportedException aus.
Explizite SchnittstellenimplementierungPrivate MethodeIList.IndexOfInfrastruktur. Implementiert die IndexOf-Methode. Löst in allen Fällen eine NotSupportedException aus.
Explizite SchnittstellenimplementierungPrivate MethodeIList.InsertInfrastruktur. Implementiert die Insert-Methode. Löst in allen Fällen eine NotSupportedException aus.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.IsFixedSizeInfrastruktur. Ruft einen Wert ab, der angibt, ob ImageList.ImageCollection eine feste Größe hat.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.ItemInfrastruktur. Ruft ein Bild aus einer vorhandenen ImageList.ImageCollection ab oder legt dieses fest.
Explizite SchnittstellenimplementierungPrivate MethodeIList.RemoveInfrastruktur. Implementiert Remove. Löst in allen Fällen eine NotSupportedException aus.
Zum Seitenanfang

Damit werden die Bilder in ImageList programmgesteuert verwaltet und Methoden zum Hinzufügen und Entfernen von Bildobjekten bereitgestellt.

Im folgenden Codebeispiel wird das Auswählen, Entfernen und Anzeigen von Bildern aus der Images-Eigenschaft der ImageList-Klasse veranschaulicht, die ein ImageList.ImageCollection-Typ ist.


namespace myImageRotator
{
	using System;
	using System.Drawing;
	using System.ComponentModel;
	using System.Windows.Forms;

	public class Form1 : System.Windows.Forms.Form
	{
		private System.ComponentModel.IContainer components;
		private System.Windows.Forms.ListBox listBox1;
		private System.Windows.Forms.Label label3;
		private System.Windows.Forms.Button button1;
		private System.Windows.Forms.Button button2;
		private System.Windows.Forms.Button button3;
		private System.Windows.Forms.Button button4;
		private System.Windows.Forms.PictureBox pictureBox1;
		private System.Windows.Forms.ImageList imageList1;
		private System.Windows.Forms.OpenFileDialog openFileDialog1;
		protected Graphics myGraphics;
		private System.Windows.Forms.Panel panel1;
		private System.Windows.Forms.Label label5;
		private int currentImage = 0;

		public Form1()
		{
			InitializeComponent();
			imageList1 = new ImageList () ;

			// The default image size is 16 x 16, which sets up a larger
			// image size. 
			imageList1.ImageSize = new Size(255,255);
			imageList1.TransparentColor = Color.White;

			// Assigns the graphics object to use in the draw options.
			myGraphics = Graphics.FromHwnd(panel1.Handle);
		}

        private void InitializeComponent()
        {
            this.components = new System.ComponentModel.Container();
            this.listBox1 = new System.Windows.Forms.ListBox();
            this.label3 = new System.Windows.Forms.Label();
            this.button1 = new System.Windows.Forms.Button();
            this.button2 = new System.Windows.Forms.Button();
            this.button3 = new System.Windows.Forms.Button();
            this.button4 = new System.Windows.Forms.Button();
            this.pictureBox1 = new System.Windows.Forms.PictureBox();
            this.imageList1 = new System.Windows.Forms.ImageList(this.components);
            this.openFileDialog1 = new System.Windows.Forms.OpenFileDialog();
            this.panel1 = new System.Windows.Forms.Panel();
            this.label5 = new System.Windows.Forms.Label();
            this.SuspendLayout();

            this.listBox1.Location = new System.Drawing.Point(16, 16);
            this.listBox1.Size = new System.Drawing.Size(400, 95);
            this.listBox1.TabIndex = 0;

            this.label3.Location = new System.Drawing.Point(24, 168);
            this.label3.Text = "label3";

            this.button1.Location = new System.Drawing.Point(96, 128);
            this.button1.Size = new System.Drawing.Size(104, 23);
            this.button1.Text = "Show Next Image";
            this.button1.Click += new System.EventHandler(this.button1_Click);

            this.button2.Location = new System.Drawing.Point(208, 128);
            this.button2.Size = new System.Drawing.Size(104, 23);
            this.button2.Text = "Remove Image";
            this.button2.Click += new System.EventHandler(this.button2_Click);

            this.button3.Location = new System.Drawing.Point(320, 128);
            this.button3.Text = "Clear List";
            this.button3.Click += new System.EventHandler(this.button3_Click);

            this.button4.Location = new System.Drawing.Point(16, 128);
            this.button4.Text = "Open Image";
            this.button4.Click += new System.EventHandler(this.button4_Click);

            this.pictureBox1.Location = new System.Drawing.Point(328, 232);
            this.pictureBox1.Size = new System.Drawing.Size(336, 192);

            this.imageList1.ImageSize = new System.Drawing.Size(16, 16);
            this.imageList1.TransparentColor = System.Drawing.Color.Transparent;

            this.panel1.Location = new System.Drawing.Point(8, 240);
            this.panel1.Size = new System.Drawing.Size(296, 184);

            this.label5.Location = new System.Drawing.Point(168, 168);
            this.label5.Size = new System.Drawing.Size(312, 40);
            this.label5.Text = "label5";

            this.ClientSize = new System.Drawing.Size(672, 461);
            this.Controls.Add(this.label5);
            this.Controls.Add(this.panel1);
            this.Controls.Add(this.pictureBox1);
            this.Controls.Add(this.button4);
            this.Controls.Add(this.button3);
            this.Controls.Add(this.button2);
            this.Controls.Add(this.button1);
            this.Controls.Add(this.label3);
            this.Controls.Add(this.listBox1);
            this.ResumeLayout(false);
        }

        // Display the image.
        private void button1_Click (object sender, System.EventArgs e)
		{
			if(imageList1.Images.Empty != true)
			{
				if(imageList1.Images.Count-1 > currentImage)
				{
					currentImage++;
				}
				else
				{
					currentImage=0;
				}
				panel1.Refresh();

                // Draw the image in the panel.
				imageList1.Draw(myGraphics,10,10,currentImage);

                // Show the image in the PictureBox.
				pictureBox1.Image = imageList1.Images[currentImage];
				label3.Text = "Current image is " + currentImage ;
				listBox1.SelectedIndex = currentImage;
				label5.Text = "Image is " + listBox1.Text ;
            }
		}

        // Remove the image.
		private void button2_Click (object sender, System.EventArgs e)
		{
			imageList1.Images.RemoveAt(listBox1.SelectedIndex);
			listBox1.Items.Remove(listBox1.SelectedItem);
		}

        // Clear all images.
		private void button3_Click (object sender, System.EventArgs e)
		{
			imageList1.Images.Clear();
			listBox1.Items.Clear();
		}

        // Find an image.
		private void button4_Click (object sender, System.EventArgs e)
		{
			openFileDialog1.Multiselect = true ;
			if(openFileDialog1.ShowDialog() == DialogResult.OK)
			{
				if (openFileDialog1.FileNames != null)
				{
					for(int i =0 ; i < openFileDialog1.FileNames.Length ; i++ )
					{
						addImage(openFileDialog1.FileNames[i]);
					}
				}
				else
					addImage(openFileDialog1.FileName);
			}

		}

		private void addImage(string imageToLoad)
		{
			if (imageToLoad != "")
			{
				imageList1.Images.Add(Image.FromFile(imageToLoad));
				listBox1.BeginUpdate();
				listBox1.Items.Add(imageToLoad);
				listBox1.EndUpdate();
			}
		}
        [STAThread]
        public static void Main(string[] args) 
		{
			Application.Run(new Form1());
		}
	}
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
© 2013 Microsoft. Alle Rechte vorbehalten.