ComboBox.SelectedText Propriedade

Definição

Obtém ou define o texto selecionado na parte editável de um 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

Valor de Propriedade

Uma cadeia que representa o texto atualmente selecionado na caixa combinada. Se DropDownStyle for definido como DropDownList, o valor de retorno é uma cadeia vazia ("").

Atributos

Observações

Pode usar a SelectedText propriedade para recuperar ou alterar o texto atualmente selecionado num ComboBox controlo. No entanto, deve estar ciente de que a seleção pode mudar automaticamente devido à interação do utilizador. Por exemplo, se recuperares o SelectedText valor num handler de eventos de botão Click , o valor será uma cadeia vazia. Isto acontece porque a seleção é automaticamente apagada quando o foco de entrada passa da caixa de combo para o botão.

Quando a caixa de combo perde o foco, o ponto de seleção passa para o início do texto e qualquer texto selecionado fica desselecionado. Neste caso, obter a SelectedText propriedade recupera uma cadeia vazia, e definir a SelectedText propriedade adiciona o valor especificado ao início do texto.

Quando a caixa de combo ganha foco, o texto completo no controlo é automaticamente selecionado. Se chamar o método do Focus controlo para definir o foco de entrada, o texto completo é selecionado independentemente de o controlo já ter foco.

Quando o utilizador seleciona um item da lista suspensa ou usando as teclas SETA PARA CIMA e SETA PARA BAIXO, o texto para o novo item é automaticamente selecionado. No entanto, se tentares obter o SelectedText valor num SelectedIndexChanged handler de eventos, SelectedValueChanged a propriedade devolve uma string vazia. Isto deve-se ao facto de, no momento destes eventos, o valor anterior SelectedText já tinha sido compensado e o novo ainda não foi definido. Para recuperar o valor atual num SelectedIndexChanged gestor de eventos, SelectedValueChanged use a SelectedItem propriedade em vez disso.

Aplica-se a