Partilhar via


ComboBox.AutoCompleteSource Propriedade

Definição

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, set
Public Property AutoCompleteSource As AutoCompleteSource

Valor da propriedade

AutoCompleteSource

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.

Aplica-se a

Confira também