Exporter (0) Imprimer
Développer tout

ListBox.SelectedIndex, propriété

Mise à jour : novembre 2007

Obtient ou définit l'index de base zéro de l'élément actuellement sélectionné dans ListBox.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(false)]
[BindableAttribute(true)]
public override int SelectedIndex { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute BindableAttribute(true) */
public int get_SelectedIndex()
/** @property */
/** @attribute BrowsableAttribute(false) */
/** @attribute BindableAttribute(true) */
public  void set_SelectedIndex(int value)

public override function get SelectedIndex () : int
public override function set SelectedIndex (value : int)

Valeur de propriété

Type : System.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é.

ExceptionCondition
ArgumentOutOfRangeException

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

ArgumentException

La propriété SelectionMode a la valeur None.

Pour un ListBox standard, vous pouvez utiliser cette propriété pour déterminer l'index de l'élément qui est sélectionné dans ListBox. Si la propriété SelectionMode de ListBox a la valeur SelectionMode.MultiSimple ou SelectionMode.MultiExtended (ce qui indique un ListBox à sélections multiples) et plusieurs éléments sont sélectionnés dans la liste, cette propriété peut retourner n'index d'un élément sélectionné quelconque.

Pour récupérer une collection contenant les index de tous les éléments sélectionnés dans une ListBox à sélection multiple, utilisez la propriété SelectedIndices. Si vous souhaitez obtenir l'élément actuellement sélectionné dans ListBox, utilisez la propriété SelectedItem. De plus, vous pouvez utiliser la propriété SelectedItems pour obtenir tous les éléments sélectionnés dans un ListBox à sélections multiples.

L'exemple suivant illustre l'utilisation de la propriété SelectedIndex avec la propriété TopIndex pour déplacer l'élément actuellement sélectionné en haut de la liste d'éléments dans la zone d'affichage de ListBox. L'exemple illustre également comment supprimer des éléments à l'aide de la méthode RemoveAt de la classe System.Windows.Forms.ListBox.ObjectCollection et comment effacer toute sélection d'éléments à l'aide de la méthode ClearSelected. Le code déplace tout d'abord l'élément actuellement sélectionné dans ListBox, en haut de la liste. Il supprime ensuite tous les éléments situés avant l'élément actuellement sélectionné et efface toutes les sélections dans ListBox. Cet exemple requiert qu'un ListBox contenant les éléments 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.get_TopIndex() != listBox1.get_SelectedIndex()) {
        // Make the currently selected item the top item in the ListBox.
        listBox1.set_TopIndex(listBox1.get_SelectedIndex());
    }
    // Remove all items before the top item in the ListBox.
    for (int x = listBox1.get_SelectedIndex() - 1; x >= 0; x--) {
        listBox1.get_Items().RemoveAt(x);
    }
    // Clear all selections in the ListBox.
    listBox1.ClearSelected();
} //RemoveTopItems


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Pocket PC

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft