ListBox.ObjectCollection.RemoveAt(Int32) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

移除集合中指定索引处的项。

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)

参数

index

Int32

要移除的项的从零开始的索引。

实现

RemoveAt(Int32)

例外

ArgumentOutOfRangeException

index 参数或者小于零，或者大于或等于 Count 类的 ListBox.ObjectCollection 属性的值。

示例

下面的代码示例演示如何将 SelectedIndex 属性与 TopIndex 属性结合使用，将当前选定的项移动到显示区域中 ListBox项列表顶部。 该示例进一步演示如何使用 RemoveAt 类的方法 System.Windows.Forms.ListBox.ObjectCollection 删除项，以及如何使用 ClearSelected 该方法清除所有项选择。 代码首先将当前选定的项 ListBox 移动到列表顶部。 然后，代码将删除当前选定项之前的所有项，并清除所有 ListBox选定内容。 此示例要求 ListBox 将包含项添加到窗体中，并且当前在窗体 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

注解

从列表中删除项时，索引会更改列表中的后续项。 删除有关已删除项的所有信息。 可以通过指定要从列表中删除的项的索引，使用此方法从列表中删除特定项。 若要指定要删除的项而不是项的索引，请使用 Remove 该方法。 若要从列表中删除所有项，请使用 Clear 该方法。

另请参阅

• Clear()
• Remove(Object)