Partilhar via


ComboBox.AutoCompleteMode Propriedade

Definição

Obtém ou define uma opção que controla como o preenchimento automático funciona para o ComboBox.

public:
 property System::Windows::Forms::AutoCompleteMode AutoCompleteMode { System::Windows::Forms::AutoCompleteMode get(); void set(System::Windows::Forms::AutoCompleteMode value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteMode AutoCompleteMode { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, set
Public Property AutoCompleteMode As AutoCompleteMode

Valor da propriedade

AutoCompleteMode

Um dos valores de AutoCompleteMode. Os valores são Append, None, Suggest e SuggestAppend. O padrão é None.

Atributos

Exceções

O valor especificado não é um dos valores de AutoCompleteMode.

Comentários

Use o AutoCompleteCustomSource, AutoCompleteModee AutoCompleteSource as propriedades para criar um ComboBox que conclua automaticamente as cadeias de caracteres de entrada comparando o prefixo que está sendo inserido com os prefixos de todas as cadeias de caracteres em uma origem mantida. Isso é útil para ComboBox controles nos quais URLs, endereços, nomes de arquivo ou comandos serão inseridos com frequência. Se houver entradas duplicadas na origem mantida, a conclusão automática se comportará de forma imprevisível.

Se você definir ComboBoxStyle como DropDownList, a lista será exibida somente se AutoCompleteMode for Suggest ou SuggestAppend.

O uso da AutoCompleteCustomSource propriedade é opcional, mas você deve definir a AutoCompleteSource propriedade para CustomSource usar AutoCompleteCustomSource.

Você deve usar as propriedades e as AutoCompleteMode AutoCompleteSource propriedades juntas.

Com AutoCompleteMode definido como SuggestAppend e AutoCompleteSource definido como ListItems, o comportamento é o seguinte:

  • Se a lista de cadeias de caracteres estiver vazia, pressionar a tecla BACKSPACE ou DELETE não fará nada.

  • Se a tecla BACKSPACE for pressionada em menos de um segundo, o item anterior será selecionado ou nada será selecionado se a lista de cadeia de caracteres estiver vazia.

  • Se a tecla BACKSPACE for pressionada em mais de um segundo, o primeiro item será selecionado.

  • Se a tecla DELETE for pressionada, o primeiro item será selecionado.

Observação

O sistema operacional pode limitar o número de cadeias de caracteres personalizadas que ele pode exibir ao mesmo tempo. Para cadeias de caracteres que contêm uma barra (/) ou barra para trás (\), a conclusão automática acrescenta todos os caracteres somente até e incluindo a barra.

Aplica-se a

Confira também