ComboBox.SelectedText Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit le texte qui est sélectionné dans la partie modifiable d'un ComboBox.

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

Valeur de propriété

String

Chaîne représentant le texte actuellement sélectionné dans la zone de liste déroulante. Si DropDownStyle a la valeur DropDownList, la valeur de retour est une chaîne vide ("").

Attributs

BrowsableAttribute

Remarques

Vous pouvez utiliser la SelectedText propriété pour récupérer ou modifier le texte actuellement sélectionné dans un ComboBox contrôle. Toutefois, vous devez savoir que la sélection peut changer automatiquement en raison de l’interaction de l’utilisateur. Par exemple, si vous récupérez la SelectedText valeur dans un gestionnaire d’événements de bouton Click , la valeur sera une chaîne vide. En effet, la sélection est automatiquement effacée lorsque le focus d’entrée passe de la zone de liste déroulante au bouton.

Lorsque la zone de liste modifiable perd le focus, le point de sélection se déplace au début du texte et tout texte sélectionné devient désélectionné. Dans ce cas, l’obtention de la SelectedText propriété récupère une chaîne vide et la définition de la SelectedText propriété ajoute la valeur spécifiée au début du texte.

Lorsque la zone de liste modifiable obtient le focus, le texte intégral dans le contrôle est automatiquement sélectionné. Si vous appelez la méthode du Focus contrôle pour définir le focus d’entrée, le texte intégral est sélectionné, que le contrôle ait déjà le focus.

Lorsque l’utilisateur sélectionne un élément dans la liste déroulante ou à l’aide des touches FLÈCHE HAUT et FLÈCHE BAS, le texte du nouvel élément est automatiquement sélectionné. Toutefois, si vous essayez d’obtenir la SelectedText valeur dans un gestionnaire d’événements SelectedIndexChanged ou SelectedValueChanged , la propriété retourne une chaîne vide. En effet, au moment de ces événements, la valeur précédente SelectedText a été effacée et la nouvelle valeur n’a pas encore été définie. Pour récupérer la valeur actuelle dans un gestionnaire d’événements SelectedIndexChanged ou, SelectedValueChanged utilisez plutôt la SelectedItem propriété .