ListBox.ObjectCollection.RemoveAt(Int32) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ListBox.ObjectCollection.cs

Rimuove l'elemento in corrispondenza dell'indice specificato all'interno dell'insieme.

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)

Parametri

index

Int32

Indice in base zero dell'elemento da rimuovere.

Implementazioni

RemoveAt(Int32)

Eccezioni

ArgumentOutOfRangeException

Il index parametro è minore di zero o maggiore o uguale al valore della Count proprietà della ListBox.ObjectCollection classe .

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la proprietà con la SelectedIndexTopIndex proprietà per spostare l'elemento attualmente selezionato all'inizio dell'elenco di elementi nell'area di visualizzazione dell'oggetto ListBox. Nell'esempio viene illustrato ulteriormente come rimuovere elementi usando il RemoveAt metodo della System.Windows.Forms.ListBox.ObjectCollection classe e come cancellare la selezione di tutti gli elementi usando il ClearSelected metodo . Il codice sposta innanzitutto l'elemento attualmente selezionato nell'oggetto ListBox all'inizio dell'elenco. Il codice rimuove quindi tutti gli elementi prima dell'elemento attualmente selezionato e cancella tutte le selezioni nell'oggetto ListBox. In questo esempio è necessario che un ListBox elemento contenitore venga aggiunto a un modulo e che un elemento sia attualmente selezionato in 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

Commenti

Quando si rimuove un elemento dall'elenco, gli indici cambiano per gli elementi successivi nell'elenco. Tutte le informazioni sull'elemento rimosso vengono eliminate. È possibile utilizzare questo metodo per rimuovere un elemento specifico dall'elenco specificando l'indice dell'elemento da rimuovere dall'elenco. Per specificare l'elemento da rimuovere anziché l'indice per l'elemento, utilizzare il Remove metodo . Per rimuovere tutti gli elementi dall'elenco, utilizzare il Clear metodo .

Vedi anche

• Clear()
• Remove(Object)