ListBox.ObjectCollection.RemoveAt(Int32) Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Supprime l'élément à l'index spécifié dans la collection.

public:
 virtual void RemoveAt(int index);

public void RemoveAt (int index);

abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit

Public Sub RemoveAt (index As Integer)

Paramètres

index: Int32

Index de base zéro de l'élément à supprimer.

Implémente

RemoveAt(Int32)

Exceptions

ArgumentOutOfRangeException

Le paramètre index est inférieur à zéro ou supérieur ou égal à la valeur de la propriété Count de la classe ListBox.ObjectCollection.

Exemples

L’exemple de code suivant montre comment utiliser la SelectedIndex propriété avec la TopIndex propriété pour déplacer l’élément actuellement sélectionné en haut de la liste des éléments dans la zone d’affichage du ListBox. L’exemple montre également comment supprimer des éléments à l’aide de la RemoveAt méthode de la System.Windows.Forms.ListBox.ObjectCollection classe et comment effacer toute sélection d’élément à l’aide de la ClearSelected méthode . Le code déplace d’abord l’élément actuellement sélectionné dans le ListBox vers le haut de la liste. Le code supprime ensuite tous les éléments avant l’élément actuellement sélectionné et efface toutes les sélections dans le ListBox. Cet exemple nécessite qu’un ListBox élément contenant soit ajouté à un formulaire et qu’un élément soit actuellement sélectionné dans le ListBox.

private:
   void RemoveTopItems()
   {
      // Determine if the currently selected item in the ListBox 
      // is the item displayed at the top in the ListBox.
      if ( listBox1->TopIndex != listBox1->SelectedIndex )

      // Make the currently selected item the top item in the ListBox.
      listBox1->TopIndex = listBox1->SelectedIndex;

      // Remove all items before the top item in the ListBox.
      for ( int x = (listBox1->SelectedIndex - 1); x >= 0; x-- )
      {
         listBox1->Items->RemoveAt( x );
      }

      // Clear all selections in the ListBox.
      listBox1->ClearSelected();
   }

private void RemoveTopItems()
{
   // Determine if the currently selected item in the ListBox 
   // is the item displayed at the top in the ListBox.
   if (listBox1.TopIndex != listBox1.SelectedIndex)
      // Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex;

   // Remove all items before the top item in the ListBox.
   for (int x = (listBox1.SelectedIndex -1); x >= 0; x--)
   {
      listBox1.Items.RemoveAt(x);
   }

   // Clear all selections in the ListBox.
   listBox1.ClearSelected();
}

Private Sub RemoveTopItems()
   ' Determine if the currently selected item in the ListBox 
   ' is the item displayed at the top in the ListBox.
   If listBox1.TopIndex <> listBox1.SelectedIndex Then
      ' Make the currently selected item the top item in the ListBox.
      listBox1.TopIndex = listBox1.SelectedIndex
   End If
   ' Remove all items before the top item in the ListBox.
   Dim x As Integer
   For x = listBox1.SelectedIndex - 1 To 0 Step -1
      listBox1.Items.RemoveAt(x)
   Next x

   ' Clear all selections in the ListBox.
   listBox1.ClearSelected()
End Sub

Remarques

Lorsque vous supprimez un élément de la liste, les index changent pour les éléments suivants de la liste. Toutes les informations relatives à l’élément supprimé sont supprimées. Vous pouvez utiliser cette méthode pour supprimer un élément spécifique de la liste en spécifiant l’index de l’élément à supprimer de la liste. Pour spécifier l’élément à supprimer au lieu de l’index de l’élément, utilisez la Remove méthode . Pour supprimer tous les éléments de la liste, utilisez la Clear méthode .

S’applique à