ListBox.SelectedItem Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das derzeit ausgewählte Element in ListBox ab oder legt dieses fest.

public:
 property System::Object ^ SelectedItem { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public object? SelectedItem { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(false)>]
member this.SelectedItem : obj with get, set

Public Property SelectedItem As Object

Eigenschaftswert

Object

Ein Objekt, das die aktuelle Auswahl im Steuerelement darstellt.

Attribute

BindableAttribute BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das SelectedIndexChanged -Ereignis verwendet wird, um in einem anderen ListBox Steuerelement nach einem Element zu suchen und es auszuwählen. Im Beispiel wird das SelectedIndexChanged -Ereignis verwendet, um zu bestimmen, wann das ausgewählte Element im ListBox geändert wird. Der Beispielcode liest dann den Text des Elements mithilfe der SelectedItem -Eigenschaft und ruft die FindString -Methode für eine andere ListBox auf, wobei der Text verwendet wird, der von SelectedItem im ersten ListBoxzurückgegeben wird. Wenn ein Element in der anderen ListBoxgefunden wird, wird das Element ausgewählt. In diesem Beispiel müssen einem Formular zwei ListBox Steuerelemente mit dem Namen listBox1 und listBox2hinzugefügt werden, und dass beide ListBox Steuerelemente identische Elemente enthalten. Das Beispiel erfordert auch, dass die im Beispiel definierte Ereignisbehandlungsmethode mit dem SelectedIndexChanged -Ereignis von listBox1verbunden ist.

private:
   void listBox1_SelectedIndexChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Get the currently selected item in the ListBox.
      String^ curItem = listBox1->SelectedItem->ToString();

      // Find the string in ListBox2.
      int index = listBox2->FindString( curItem );

      // If the item was not found in ListBox 2 display a message box,
      //  otherwise select it in ListBox2.
      if ( index == -1 )
            MessageBox::Show( "Item is not available in ListBox2" );
      else
            listBox2->SetSelected( index, true );
   }

private void listBox1_SelectedIndexChanged(object sender, System.EventArgs e)
{
   // Get the currently selected item in the ListBox.
   string curItem = listBox1.SelectedItem.ToString();

   // Find the string in ListBox2.
   int index = listBox2.FindString(curItem);
   // If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
   if(index == -1)
      MessageBox.Show("Item is not available in ListBox2");
   else
      listBox2.SetSelected(index,true);
}

Private Sub listBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles listBox1.SelectedIndexChanged
   ' Get the currently selected item in the ListBox.
   Dim curItem As String = listBox1.SelectedItem.ToString()

   ' Find the string in ListBox2.
   Dim index As Integer = listBox2.FindString(curItem)
   ' If the item was not found in ListBox 2 display a message box, otherwise select it in ListBox2.
   If index = -1 Then
      MessageBox.Show("Item is not available in ListBox2")
   Else
      listBox2.SetSelected(index, True)
   End If
End Sub

Hinweise

Für einen Standard ListBoxkönnen Sie diese Eigenschaft verwenden, um zu bestimmen, welches Element in ListBoxausgewählt ist. Wenn die SelectionMode -Eigenschaft von ListBox auf oder SelectionMode.MultiSimpleSelectionMode.MultiExtended festgelegt ist (was eine Mehrfachauswahl ListBoxangibt) und mehrere Elemente in der Liste ausgewählt sind, kann diese Eigenschaft jedes ausgewählte Element zurückgeben.

Verwenden Sie die -Eigenschaft, um eine Auflistung abzurufen, die SelectedItems alle ausgewählten Elemente in einer Mehrfachauswahl ListBoxenthält. Wenn Sie die Indexposition des aktuell ausgewählten Elements im ListBoxabrufen möchten, verwenden Sie die SelectedIndex -Eigenschaft. Darüber hinaus können Sie die SelectedIndices -Eigenschaft verwenden, um alle ausgewählten Indizes in einer Mehrfachauswahl ListBoxabzurufen.