ListBox.SelectedIndex Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft den nullbasierten Index des derzeit ausgewählten Elements in einer ListBox ab oder legt diesen fest.

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

Eigenschaftswert

Int32

Ein nullbasierter Index des derzeit ausgewählten Elements. Wenn kein Element ausgewählt ist, wird ein Wert von -1 zurückgegeben.

Attribute
BindableAttribute BrowsableAttribute

Ausnahmen

ArgumentOutOfRangeException

Der zugeordnete Wert ist kleiner als -1 oder größer oder gleich der Elementanzahl.

ArgumentException

Die SelectionMode-Eigenschaft ist auf None festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die Eigenschaft mit der SelectedIndex TopIndex Eigenschaft verwendet wird, um das aktuell ausgewählte Element in den oberen Bereich der Liste der Elemente im Anzeigebereich des ListBoxObjekts zu verschieben. Im Beispiel wird weiter veranschaulicht, wie Elemente mithilfe der RemoveAt Methode der Klasse entfernt werden, und wie Sie alle Elementauswahl mithilfe der ClearSelected System.Windows.Forms.ListBox.ObjectCollection Methode löschen. Der Code verschiebt zuerst das aktuell ausgewählte Element im ListBox oberen Bereich der Liste. Der Code entfernt dann alle Elemente vor dem aktuell ausgewählten Element und löscht alle Auswahlen in der ListBox. In diesem Beispiel ist erforderlich, dass ein ListBox enthaltende Elemente einem Formular hinzugefügt wird und dass ein Element derzeit in der ListBoxDatei ausgewählt ist.

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

Hinweise

Für einen Standard ListBoxkönnen Sie diese Eigenschaft verwenden, um den Index des Elements zu bestimmen, das in der ListBoxDatei ausgewählt ist. Wenn die SelectionMode Eigenschaft der ListBox Eigenschaft auf eine SelectionMode.MultiSimple oder SelectionMode.MultiExtended (die eine Mehrfachauswahl ListBoxangibt) und mehrere Elemente in der Liste ausgewählt sind, kann diese Eigenschaft den Index an ein beliebiges ausgewähltes Element zurückgeben.

Um eine Auflistung abzurufen, die die Indizes aller ausgewählten Elemente in einer Mehrfachauswahl ListBoxenthält, verwenden Sie die SelectedIndices Eigenschaft. Wenn Sie das Element abrufen möchten, das derzeit in der ListBoxEigenschaft ausgewählt ist, verwenden Sie die SelectedItem Eigenschaft. Darüber hinaus können Sie die SelectedItems Eigenschaft verwenden, um alle ausgewählten Elemente in einer Mehrfachauswahl ListBoxabzurufen.

Gilt für

Siehe auch