ComboBox.SelectedText Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property SelectedText As StringValor da propriedade
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
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 .
