ComboBox.SelectedText Propriété

Définition

Obtient ou définit le texte qui est sélectionné dans la partie modifiable d'un ComboBox.Gets or sets the text that is selected in the editable portion of a ComboBox.

public:
 property System::String ^ SelectedText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public string SelectedText { get; set; }
member this.SelectedText : string with get, set
Public Property SelectedText As String

Valeur de propriété

Chaîne représentant le texte actuellement sélectionné dans la zone de liste déroulante.A string that represents the currently selected text in the combo box. Si DropDownStyle a la valeur DropDownList, la valeur de retour est une chaîne vide ("").If DropDownStyle is set to DropDownList, the return value is an empty string ("").

Attributs

Remarques

Vous pouvez utiliser la propriété SelectedText pour récupérer ou modifier le texte actuellement sélectionné dans un contrôle ComboBox.You can use the SelectedText property to retrieve or change the currently selected text in a ComboBox control. Toutefois, vous devez savoir que la sélection peut changer automatiquement en raison de l’interaction de l’utilisateur.However, you should be aware that the selection can change automatically because of user interaction. Par exemple, si vous récupérez la valeur SelectedText dans un gestionnaire d’événements Click de bouton, la valeur sera une chaîne vide.For example, if you retrieve the SelectedText value in a button Click event handler, the value will be an empty string. Cela est dû au fait que la sélection est automatiquement désactivée lorsque le focus d’entrée passe de la zone de liste déroulante au bouton.This is because the selection is automatically cleared when the input focus moves from the combo box to the button.

Lorsque la zone de liste déroulante perd le focus, le point de sélection se déplace vers le début du texte et tout texte sélectionné est désélectionné.When the combo box loses focus, the selection point moves to the beginning of the text and any selected text becomes unselected. Dans ce cas, l’obtention de la propriété SelectedText récupère une chaîne vide et la définition de la propriété SelectedText ajoute la valeur spécifiée au début du texte.In this case, getting the SelectedText property retrieves an empty string, and setting the SelectedText property adds the specified value to the beginning of the text.

Lorsque la zone de liste déroulante obtient le focus, le texte complet dans le contrôle est automatiquement sélectionné.When the combo box gains focus, the full text in the control is automatically selected. Si vous appelez la méthode Focus du contrôle pour définir le focus d’entrée, le texte complet est sélectionné, que le contrôle ait déjà le focus ou non.If you call the control's Focus method to set the input focus, the full text is selected regardless of whether the control already had focus.

Lorsque l’utilisateur sélectionne un élément dans la liste déroulante ou en utilisant les flèches haut et bas, le texte du nouvel élément est automatiquement sélectionné.When the user selects an item from the drop-down list or by using the UP ARROW and DOWN ARROW keys, the text for the new item is automatically selected. Toutefois, si vous essayez d’obtenir la valeur SelectedText dans un gestionnaire d’événements SelectedIndexChanged ou SelectedValueChanged, la propriété retourne une chaîne vide.However, if you try to get the SelectedText value in a SelectedIndexChanged or SelectedValueChanged event handler, the property returns an empty string. Cela est dû au fait que, au moment de ces événements, la valeur de SelectedText précédente a été effacée et que la nouvelle valeur n’a pas encore été définie.This is because, at the time of these events, the previous SelectedText value has been cleared and the new value has not yet been set. Pour récupérer la valeur actuelle dans un gestionnaire d’événements SelectedIndexChanged ou SelectedValueChanged, utilisez la propriété SelectedItem à la place.To retrieve the current value in a SelectedIndexChanged or SelectedValueChanged event handler, use the SelectedItem property instead.

S’applique à