ComboBox.SelectedText Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.