ListBox.ObjectCollection.RemoveAt(Int32) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Entfernt das Element am angegebenen Index in der Auflistung.

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)

Parameter

index

Int32

Der nullbasierte Index des zu entfernenden Elements.

Implementiert

RemoveAt(Int32)

Ausnahmen

ArgumentOutOfRangeException

Der index-Parameter ist kleiner als 0 (null) bzw. größer oder gleich dem Wert der Count-Eigenschaft der ListBox.ObjectCollection-Klasse.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die SelectedIndex -Eigenschaft mit der TopIndex -Eigenschaft verwendet wird, um das aktuell ausgewählte Element an den Anfang der Liste der Elemente im Anzeigebereich des ListBoxzu verschieben. Im Beispiel wird weiter veranschaulicht, wie Elemente mithilfe der RemoveAt -Methode der System.Windows.Forms.ListBox.ObjectCollection -Klasse entfernt und die gesamte Elementauswahl mithilfe der ClearSelected -Methode gelöscht wird. Der Code verschiebt zuerst das aktuell ausgewählte Element im ListBox an den Anfang der Liste. Der Code entfernt dann alle Elemente vor dem aktuell ausgewählten Element und löscht alle Markierungen im ListBox. Dieses Beispiel erfordert, dass ein ListBox enthaltende Elemente zu einem Formular hinzugefügt wird und dass ein Element derzeit im ListBoxausgewählt ist.

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

Hinweise

Wenn Sie ein Element aus der Liste entfernen, ändern sich die Indizes für nachfolgende Elemente in der Liste. Alle Informationen zum entfernten Element werden gelöscht. Sie können diese Methode verwenden, um ein bestimmtes Element aus der Liste zu entfernen, indem Sie den Index des Elements angeben, das aus der Liste entfernt werden soll. Verwenden Remove Sie die -Methode, um das zu entfernende Element anstelle des Indexes für das Element anzugeben. Verwenden Sie die -Methode, um alle Elemente aus der Clear Liste zu entfernen.

Weitere Informationen

• Clear()
• Remove(Object)