ListBox.SelectedIndex Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает отсчитываемый от нуля индекс выбранного элемента в объекте 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
Значение свойства
Отсчитываемый от нуля индекс выбранного элемента. Значение отрицательного (-1) возвращается, если элемент не выбран.
- Атрибуты
Исключения
Назначенное значение меньше -1 или больше или равно числу элементов.
Для свойства 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 Если в списке задано SelectionMode.MultiSimple свойство ListBox или SelectionMode.MultiExtended (которое указывает на несколько элементовListBox) и несколько элементов выбраны в списке, это свойство может вернуть индекс любому выбранному элементу.
Чтобы получить коллекцию, содержащую индексы всех выбранных элементов в нескольких выборах ListBox, используйте SelectedIndices это свойство. Если вы хотите получить элемент, выбранный в данный момент, ListBoxиспользуйте SelectedItem свойство. Кроме того, свойство можно использовать SelectedItems для получения всех выбранных элементов в нескольких выборах ListBox.