ComboBox.SelectedText Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Text ab, der im Bearbeitungsbereich von ComboBox markiert ist, oder legt diesen fest.

public:
 property System::String ^ SelectedText { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string SelectedText { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedText : string with get, set

Public Property SelectedText As String

Eigenschaftswert

String

Eine Zeichenfolge, die den derzeit markierten Text im Kombinationsfeld darstellt. Wenn der DropDownStyle auf DropDownList festgelegt ist, ist der Rückgabewert eine leere Zeichenfolge ("").

Attribute

BrowsableAttribute

Hinweise

Sie können die SelectedText -Eigenschaft verwenden, um den aktuell ausgewählten Text in einem ComboBox Steuerelement abzurufen oder zu ändern. Sie sollten sich jedoch bewusst sein, dass sich die Auswahl aufgrund von Benutzerinteraktionen automatisch ändern kann. Wenn Sie beispielsweise den SelectedText Wert in einem Schaltflächenereignishandler Click abrufen, ist der Wert eine leere Zeichenfolge. Dies liegt daran, dass die Auswahl automatisch gelöscht wird, wenn der Eingabefokus vom Kombinationsfeld zur Schaltfläche wechselt.

Wenn das Kombinationsfeld den Fokus verliert, wird der Auswahlpunkt an den Anfang des Texts verschoben, und der ausgewählte Text wird deaktiviert. In diesem Fall wird beim Abrufen der SelectedText -Eigenschaft eine leere Zeichenfolge abgerufen, und beim Festlegen der SelectedText Eigenschaft wird der angegebene Wert am Anfang des Texts hinzugefügt.

Wenn das Kombinationsfeld den Fokus erhält, wird automatisch der Volltext im Steuerelement ausgewählt. Wenn Sie die -Methode des Steuerelements Focus aufrufen, um den Eingabefokus festzulegen, wird der Volltext ausgewählt, unabhängig davon, ob das Steuerelement bereits den Fokus hatte.

Wenn der Benutzer ein Element aus der Dropdownliste oder mithilfe der NACH-OBEN- und NACH-UNTEN-TASTE auswählt, wird der Text für das neue Element automatisch ausgewählt. Wenn Sie jedoch versuchen, den SelectedText Wert in einem - oder SelectedValueChanged -SelectedIndexChangedEreignishandler abzurufen, gibt die -Eigenschaft eine leere Zeichenfolge zurück. Dies liegt daran, dass zum Zeitpunkt dieser Ereignisse der vorherige SelectedText Wert gelöscht und der neue Wert noch nicht festgelegt wurde. Verwenden Sie SelectedItem stattdessen die -Eigenschaft, um den aktuellen Wert in einem SelectedIndexChanged - oder SelectedValueChanged -Ereignishandler abzurufen.