ComboBox.SelectedText Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 da propriedade

String

Uma cadeia de caracteres que representa o texto selecionado no momento na caixa de combinação. Se DropDownStyle for definido como DropDownList, o valor retornado será uma cadeia de caracteres vazia ("").

Atributos

BrowsableAttribute

Comentários

Você pode usar a SelectedText propriedade para recuperar ou alterar o texto selecionado no momento em um ComboBox controle. No entanto, você deve estar ciente de que a seleção pode ser alterada automaticamente devido à interação do usuário. Por exemplo, se você recuperar o SelectedText valor em um manipulador de eventos de botão Click , o valor será uma cadeia de caracteres vazia. Isso ocorre porque a seleção é desmarcada automaticamente quando o foco de entrada passa da caixa de combinação para o botão.

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

Quando a caixa de combinação ganha foco, o texto completo no controle é selecionado automaticamente. Se você chamar o método do Focus controle para definir o foco de entrada, o texto completo será selecionado independentemente de o controle já ter o foco.

Quando o usuário seleciona um item na lista suspensa ou usando as teclas SETA PARA CIMA e SETA PARA BAIXO, o texto do novo item é selecionado automaticamente. No entanto, se você tentar obter o SelectedText valor em um SelectedIndexChanged manipulador de eventos ou SelectedValueChanged , a propriedade retornará uma cadeia de caracteres vazia. Isso ocorre porque, no momento desses eventos, o valor anterior SelectedText foi limpo e o novo valor ainda não foi definido. Para recuperar o valor atual em um SelectedIndexChanged manipulador de eventos ou SelectedValueChanged , use a SelectedItem propriedade .