ListBox.SelectedIndex Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает индекс выделенной в настоящий момент позиции в элементе управления ListBox (индекс, начинающийся с нуля).

public:
 virtual property int SelectedIndex { int get(); void set(int value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public override int SelectedIndex { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, set

Public Overrides Property SelectedIndex As Integer

Значение свойства

Int32

Индекс текущего выделенного элемента (индексация ведется с нуля). Если элемент не выбран, возвращается отрицательное значение (-1).

Атрибуты

BindableAttribute BrowsableAttribute

Исключения

ArgumentOutOfRangeException

Назначенное значение параметра меньше -1 или больше или равно количеству элементов.

ArgumentException

Свойству SelectionMode задано значение None.

Примеры

В следующем примере кода показано, как использовать 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

Комментарии

Для стандартного ListBoxсвойства это свойство можно использовать для определения индекса элемента, выбранного в элементе ListBox. Если свойству SelectionMode ListBox объекта присвоено SelectionMode.MultiSimple значение или SelectionMode.MultiExtended (которое указывает на множественный выбор ListBox) и в списке выбрано несколько элементов, это свойство может вернуть индекс любому выбранному элементу.

Чтобы получить коллекцию, содержащую индексы всех выбранных элементов в множественном выборе ListBox, используйте SelectedIndices свойство. Если вы хотите получить элемент, выбранный в данный момент, ListBoxиспользуйте SelectedItem свойство. Кроме того, свойство можно использовать SelectedItems для получения всех выбранных элементов в множественном выборе ListBox.

См. также раздел

• SelectedIndices
• SelectedItems
• SelectedItem