ListBox.SelectedIndex Eigenschap

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

Waarde van eigenschap

Een op nul gebaseerde index van het geselecteerde item. Een waarde van een negatieve waarde (-1) wordt geretourneerd als er geen item is geselecteerd.

Kenmerken

BindableAttribute BrowsableAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de SelectedIndex eigenschap gebruikt met de TopIndex eigenschap om het geselecteerde item naar de bovenkant van de lijst met items in het weergavegebied van het ListBoxitem te verplaatsen. In het voorbeeld ziet u verder hoe u items verwijdert met behulp van de methode RemoveAt van de klasse System.Windows.Forms.ListBox.ObjectCollection en hoe u alle itemselectie kunt wissen met behulp van de methode ClearSelected. Met de code wordt eerst het geselecteerde item boven aan ListBox de lijst verplaatst. De code verwijdert vervolgens alle items vóór het geselecteerde item en wist alle selecties in de ListBox. In dit voorbeeld moet een ListBox item met items worden toegevoegd aan een formulier en dat er momenteel een item is geselecteerd in het ListBoxformulier.

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

Opmerkingen

Voor een standaard ListBoxkunt u deze eigenschap gebruiken om de index te bepalen van het item dat is geselecteerd in de ListBox. Als de eigenschap van de ListBoxSelectionMode eigenschap is ingesteld op of SelectionMode.MultiExtendedSelectionMode.MultiSimple (wat een meervoudige selectie ListBoxaangeeft) en meerdere items zijn geselecteerd in de lijst, kan deze eigenschap de index retourneren aan een geselecteerd item.

Als u een verzameling met de indexen van alle geselecteerde items in een meervoudige selectie wilt ophalen, gebruikt u ListBoxde SelectedIndices eigenschap. Als u het item wilt ophalen dat momenteel is geselecteerd in de ListBox, gebruikt u de SelectedItem eigenschap. Daarnaast kunt u de SelectedItems eigenschap gebruiken om alle geselecteerde items in een meervoudige selectie ListBoxte verkrijgen.

Zie ook

• SelectedIndices
• SelectedItems
• SelectedItem