Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ListBox.ObjectCollection, classe

Représente la collection d'éléments dans un ListBox.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[ListBindableAttribute(false)]
public class ObjectCollection : IList, 
	ICollection, IEnumerable

Le type ListBox.ObjectCollection expose les membres suivants.

  NomDescription
Méthode publiqueListBox.ObjectCollection(ListBox)Initialise une nouvelle instance d'ListBox.ObjectCollection.
Méthode publiqueListBox.ObjectCollection(ListBox, Object[])Initialise une nouvelle instance de ListBox.ObjectCollection contenant un tableau d'objets.
Méthode publiqueListBox.ObjectCollection(ListBox, ListBox.ObjectCollection)Initiative une nouvelle instance de ListBox.ObjectCollection basée sur un autre ListBox.ObjectCollection.
Début

  NomDescription
Propriété publiqueCountObtient le nombre d'éléments de la collection.
Propriété publiqueIsReadOnlyObtient une valeur indiquant si la collection est en lecture seule.
Propriété publiqueItemObtient ou définit l'élément à l'index spécifié dans la collection.
Début

  NomDescription
Méthode publiqueAddAjoute un élément à la liste d'éléments pour ListBox.
Méthode publiqueAddRange(ListBox.ObjectCollection)Ajoute les éléments d'un ListBox.ObjectCollection existant à la liste d'éléments dans ListBox.
Méthode publiqueAddRange(Object[])Ajoute un tableau d'éléments à la liste d'éléments pour ListBox.
Méthode publiqueClearSupprime tous les éléments de la collection.
Méthode publiqueContainsDétermine si l'élément spécifié réside dans la collection.
Méthode publiqueCopyToCopie la collection entière dans un tableau d'objets existant à un emplacement spécifié dans le tableau.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueGetEnumeratorRetourne un énumérateur qui peut être utilisé pour itérer au sein de la collection d'éléments.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueIndexOfRetourne l'index dans la collection de l'élément spécifié.
Méthode publiqueInsertInsère un élément dans la zone de liste à l'index spécifié.
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiqueRemoveSupprime l'objet spécifié de la collection.
Méthode publiqueRemoveAtInfrastructure. Supprime l'élément à l'index spécifié dans la collection.
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

  NomDescription
Méthode d'extension publiqueAsParallelActive la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publiqueAsQueryableConvertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publiqueCast<TResult>Effectue un cast des éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publiqueOfType<TResult>Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICollection.CopyToInfrastructure. Copie les éléments de la collection dans un tableau, en commençant au niveau d'un index de tableau particulier.
Implémentation d'interface explicitePropriété privéeICollection.IsSynchronizedInfrastructure. Pour obtenir une description de ce membre, consultez ICollection.IsSynchronized.
Implémentation d'interface explicitePropriété privéeICollection.SyncRootInfrastructure. Pour obtenir une description de ce membre, consultez ICollection.SyncRoot.
Implémentation d'interface expliciteMéthode privéeIList.AddInfrastructure. Ajoute un objet à la classe ListBox.
Implémentation d'interface explicitePropriété privéeIList.IsFixedSizeInfrastructure. Pour obtenir une description de ce membre, consultez IList.IsFixedSize.
Début

La classe ListBox.ObjectCollection stocke les éléments affichés dans ListBox. Deux autres collections définies dans la classe ListBox permettent de déterminer les éléments qui sont sélectionnés dans cette collection. La classe ListBox.SelectedObjectCollection fournit des propriétés et des méthodes pour déterminer les éléments sélectionnés dans ListBox.ObjectCollection, tandis que la classe ListBox.SelectedIndexCollection permet de déterminer les index sélectionnés dans ListBox.ObjectCollection.

Il existe différentes méthodes pour ajouter des éléments à la collection. La méthode Add permet d'ajouter un seul objet à la collection. Pour ajouter plusieurs objets à la collection, vous pouvez créer un tableau d'éléments et l'assigner à la méthode AddRange. Pour insérer un objet à un emplacement spécifique dans la collection, vous pouvez utiliser la méthode Insert. Pour supprimer des liens, vous pouvez utiliser la méthode Remove ou la méthode RemoveAt si vous savez où se trouve l'élément dans la collection. La méthode Clear vous permet de supprimer tous les éléments de la collection, contrairement à la méthode Remove qui permet de supprimer un seul élément à la fois.

Vous pouvez également manipuler les éléments de ListBox en utilisant la propriété DataSource. Si vous utilisez la propriété DataSource pour ajouter des éléments à ListBox, vous pouvez afficher les éléments dans ListBox à l'aide de la propriété Items, mais vous ne pouvez pas ajouter ou supprimer des éléments dans la liste en utilisant les méthodes de ListBox.ObjectCollection.

En plus des méthodes et des propriétés permettant d'ajouter et de supprimer des éléments, ListBox.ObjectCollection fournit également des méthodes permettant de rechercher des éléments dans la collection. La méthode Contains permet de déterminer si un objet est un membre de la collection. Lorsque vous savez que l'élément réside dans la collection, vous pouvez utiliser la méthode IndexOf pour déterminer son emplacement dans la collection.

L'exemple de code suivant illustre un ListBox owner-drawn en affectant la valeur OwnerDrawVariable à la propriété DrawMode et en gérant les événements DrawItem et MeasureItem. Il illustre aussi la définition des propriétés BorderStyle et ScrollAlwaysVisible et l'utilisation de la méthode AddRange.

Pour exécuter cet exemple, collez-le dans un formulaire vide qui importe l'espace de noms System.Drawing et l'espace de noms System.Windows.Forms. Appelez InitializeOwnerDrawnListBox depuis le constructeur du formulaire ou la méthode Load.


	internal System.Windows.Forms.ListBox ListBox1;

	private void InitializeOwnerDrawnListBox()
	{
		this.ListBox1 = new System.Windows.Forms.ListBox();

		// Set the location and size.
		ListBox1.Location = new Point(20, 20);
		ListBox1.Size = new Size(240, 240);

		// Populate the ListBox.ObjectCollection property 
		// with several strings, using the AddRange method.
		this.ListBox1.Items.AddRange(new object[]{"System.Windows.Forms", 
			"System.Drawing", "System.Xml", "System.Net", "System.Runtime.Remoting", 
			"System.Web"});

		// Turn off the scrollbar.
		ListBox1.ScrollAlwaysVisible = false;

		// Set the border style to a single, flat border.
		ListBox1.BorderStyle = BorderStyle.FixedSingle;

		// Set the DrawMode property to the OwnerDrawVariable value. 
		// This means the MeasureItem and DrawItem events must be 
		// handled.
		ListBox1.DrawMode = DrawMode.OwnerDrawVariable;
		ListBox1.MeasureItem += 
			new MeasureItemEventHandler(ListBox1_MeasureItem);
		ListBox1.DrawItem += new DrawItemEventHandler(ListBox1_DrawItem);
		this.Controls.Add(this.ListBox1);
		
	}


	// Handle the DrawItem event for an owner-drawn ListBox.
	private void ListBox1_DrawItem(object sender, DrawItemEventArgs e)
	{

		// If the item is the selected item, then draw the rectangle
		// filled in blue. The item is selected when a bitwise And  
		// of the State property and the DrawItemState.Selected 
		// property is true.
		if ((e.State & DrawItemState.Selected) == DrawItemState.Selected)
		{
			e.Graphics.FillRectangle(Brushes.CornflowerBlue, e.Bounds);
		}
		else
		{
			// Otherwise, draw the rectangle filled in beige.
			e.Graphics.FillRectangle(Brushes.Beige, e.Bounds);
		}

		// Draw a rectangle in blue around each item.
		e.Graphics.DrawRectangle(Pens.Blue, e.Bounds);

		// Draw the text in the item.
		e.Graphics.DrawString(ListBox1.Items[e.Index].ToString(),
			this.Font, Brushes.Black, e.Bounds.X, e.Bounds.Y);

		// Draw the focus rectangle around the selected item.
		e.DrawFocusRectangle();
	}

	// Handle the MeasureItem event for an owner-drawn ListBox.
	private void ListBox1_MeasureItem(object sender, 
		MeasureItemEventArgs e)
	{

		// Cast the sender object back to ListBox type.
		ListBox theListBox = (ListBox) sender;

		// Get the string contained in each item.
		string itemString = (string) theListBox.Items[e.Index];

		// Split the string at the " . "  character.
		string[] resultStrings = itemString.Split('.');

		// If the string contains more than one period, increase the 
		// height by ten pixels; otherwise, increase the height by 
		// five pixels.
		if (resultStrings.Length>2)
		{
			e.ItemHeight += 10;
		}
		else
		{
			e.ItemHeight += 5;
		}

	}




	an owner-drawn ListBox by setting the the DrawMode property to OwnerDrawVariable value and
	handling the DrawItem and MeasureItem events.  It also demonstrates setting the 
	BorderStyle and ScrollAlwaysVisible properties and using the AddRange method.

	To run this example paste it in an empty form that imports the System.Drawing
	namespace and the System.Windows.Forms namespace.


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft