Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListBox.ObjectCollection classe

 

Date de publication : novembre 2016

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)

System.Object
  System.Windows.Forms.ListBox.ObjectCollection
    System.Windows.Forms.CheckedListBox.ObjectCollection

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

NomDescription
System_CAPS_pubmethodListBox.ObjectCollection(ListBox)

Initialise une nouvelle instance de ListBox.ObjectCollection.

System_CAPS_pubmethodListBox.ObjectCollection(ListBox, Object[])

Initialise une nouvelle instance de ListBox.ObjectCollection contenant un tableau d’objets.

System_CAPS_pubmethodListBox.ObjectCollection(ListBox, ListBox.ObjectCollection)

Initialise une nouvelle instance de ListBox.ObjectCollection basée sur un autre ListBox.ObjectCollection.

NomDescription
System_CAPS_pubpropertyCount

Obtient le nombre d’éléments de la collection.

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

System_CAPS_pubpropertyItem[Int32]

Obtient ou définit l’élément à l’index spécifié dans la collection.

NomDescription
System_CAPS_pubmethodAdd(Object)

Ajoute un élément à la liste des éléments pour un ListBox.

System_CAPS_pubmethodAddRange(Object[])

Ajoute un tableau d’éléments à la liste d’éléments pour un ListBox.

System_CAPS_pubmethodAddRange(ListBox.ObjectCollection)

Ajoute les éléments d’un ListBox.ObjectCollection à la liste des éléments dans un ListBox.

System_CAPS_pubmethodClear()

Supprime tous les éléments de la collection.

System_CAPS_pubmethodContains(Object)

Détermine si l’élément spécifié se trouve dans la collection.

System_CAPS_pubmethodCopyTo(Object[], Int32)

Copie la collection entière dans un tableau d’objets à l’emplacement spécifié dans le tableau existant.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

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.)

System_CAPS_pubmethodGetEnumerator()

Retourne un énumérateur qui peut être utilisé pour parcourir la collection d’éléments.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodIndexOf(Object)

Retourne l’index dans la collection de l’élément spécifié.

System_CAPS_pubmethodInsert(Int32, Object)

Insère un élément dans la zone de liste à l'index spécifié.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodRemove(Object)

Supprime l’objet spécifié de la collection.

System_CAPS_pubmethodRemoveAt(Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Supprime l’élément à l’index spécifié dans la collection.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Copie les éléments de la collection dans un tableau, en commençant au niveau d’un index de tableau particulier.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIList.Add(Object)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Ajoute un objet à la ListBox classe.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez ICollection.IsSynchronized.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez ICollection.SyncRoot.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIList.IsFixedSize

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IList.IsFixedSize.

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

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

Il existe plusieurs façons d’ajouter des éléments à la collection. Le Add méthode offre la possibilité d’ajouter un seul objet à la collection. Pour ajouter un nombre d’objets à la collection, vous créez un tableau d’éléments et assignez-la à la AddRange (méthode). Si vous souhaitez insérer un objet à un emplacement spécifique dans la collection, vous pouvez utiliser la Insert méthode. Pour supprimer des éléments, vous pouvez utiliser la Remove méthode ou RemoveAt méthode si vous savez où se trouve l’élément dans la collection. Le Clear méthode vous permet de supprimer tous les éléments de la collection au lieu d’utiliser la Remove méthode pour supprimer un seul élément à la fois.

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

En plus des méthodes et propriétés pour ajouter et supprimer des éléments, le ListBox.ObjectCollection fournit également des méthodes pour rechercher des éléments dans la collection. Le Contains méthode vous permet de déterminer si un objet est un membre de la collection. Une fois que vous savez que l’élément se trouve dans la collection, vous pouvez utiliser la IndexOf méthode afin de déterminer où se trouve l’élément dans la collection.

L’exemple de code suivant montre un owner-drawn ListBox en définissant le DrawMode propriété le OwnerDrawVariable valeur et la gestion de la DrawItem et MeasureItem les événements. Il illustre également la définition du BorderStyle et ScrollAlwaysVisible propriétés et à l’aide de la AddRange méthode.

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

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;
	}

}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: