ComboBox.AutoCompleteMode 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 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, setPublic Property AutoCompleteMode As AutoCompleteModeValor da propriedade
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.