ListBox.SelectedIndex Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListBox.cs

Obtient ou définit l’index de base zéro de l’élément actuellement sélectionné dans un 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é. Une valeur négative (-1) est retournée si aucun élément n’est sélectionné.

Attributs

BindableAttribute BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

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

ArgumentException

La SelectionMode propriété 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 sélectionné en haut de la liste des éléments dans la zone d’affichage du ListBox. L’exemple montre également comment supprimer des éléments à l’aide de la RemoveAt méthode de la System.Windows.Forms.ListBox.ObjectCollection classe et comment effacer toute la sélection d’éléments à l’aide de la ClearSelected méthode. Le code déplace d’abord l’élément actuellement sélectionné en ListBox 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 le 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 le ListBoxfichier .

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 une norme ListBox, vous pouvez utiliser cette propriété pour déterminer l’index de l’élément sélectionné dans le ListBox. Si la SelectionMode propriété du fichier ListBox est définie SelectionMode.MultiSimple sur 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 le ListBoxfichier , utilisez 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.

Voir aussi

• SelectedIndices
• SelectedItems
• SelectedItem