ListBox.SelectedIndex Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit l'index de base zéro de l'élément actuellement sélectionné dans 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

Valeur de propriété

Int32

Index de base zéro de l'élément actuellement sélectionné. La valeur moins un (-1) est retournée si aucun élément n'est sélectionné.

Attributs: BindableAttribute BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

La valeur assignée est inférieure à -1 ou supérieure ou égale au nombre d'éléments.

ArgumentException

La propriété SelectionMode est définie sur None.

Exemples

L’exemple de code suivant montre comment utiliser la SelectedIndex propriété avec la TopIndex propriété pour déplacer l’élément actuellement sélectionné en haut de la liste des éléments dans la zone d’affichage du ListBox. L’exemple montre en outre comment supprimer des éléments à l’aide de la RemoveAt méthode de la System.Windows.Forms.ListBox.ObjectCollection classe et comment effacer toute sélection d’élément à l’aide de la ClearSelected méthode . Le code déplace d’abord l’élément actuellement sélectionné dans le ListBox vers le haut de la liste. Le code supprime ensuite tous les éléments avant l’élément actuellement sélectionné et efface toutes les sélections dans .ListBox Cet exemple nécessite qu’un ListBox élément contenant soit ajouté à un formulaire et qu’un élément soit actuellement sélectionné dans .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

Remarques

Pour un standard ListBox, vous pouvez utiliser cette propriété pour déterminer l’index de l’élément sélectionné dans .ListBox Si la SelectionMode propriété du ListBox est définie sur SelectionMode.MultiSimple ou SelectionMode.MultiExtended (ce qui indique une sélection ListBoxmultiple) et que plusieurs éléments sont sélectionnés dans la liste, cette propriété peut renvoyer l’index à n’importe quel élément sélectionné.

Pour récupérer une collection contenant les index de tous les éléments sélectionnés dans une sélection ListBoxmultiple , utilisez la SelectedIndices propriété . Si vous souhaitez obtenir l’élément actuellement sélectionné dans , ListBoxutilisez la SelectedItem propriété . En outre, vous pouvez utiliser la SelectedItems propriété pour obtenir tous les éléments sélectionnés dans une sélection ListBoxmultiple .

S’applique à