ComboBox.AutoCompleteSource 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 um valor que especifica a origem de cadeias de caracteres completas usadas para o preenchimento automático.
public:
property System::Windows::Forms::AutoCompleteSource AutoCompleteSource { System::Windows::Forms::AutoCompleteSource get(); void set(System::Windows::Forms::AutoCompleteSource value); };[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteSource AutoCompleteSource { get; set; }[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, setPublic Property AutoCompleteSource As AutoCompleteSourceValor da propriedade
Um dos valores de AutoCompleteSource. As opções são AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSourcee None. O padrão é None.
- Atributos
Exceções
O valor especificado não é um dos valores de AutoCompleteSource.
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.
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.