TextBox.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.

[System.ComponentModel.Browsable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))]
public System.Windows.Forms.AutoCompleteSource AutoCompleteSource { get; set; }

Valor 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.

Exemplos

O exemplo de código a seguir demonstra como usar uma coleção como a fonte personalizada de preenchimento automático para um TextBox controle . Este exemplo faz o seguinte:

  • Usa a AutoCompleteSource propriedade para permitir que o TextBox controle aceite uma fonte personalizada para seu comportamento de preenchimento automático.

  • Usa a AutoCompleteCustomSource propriedade para definir a lista personalizada de valores.

  • Usa a AutoCompleteMode propriedade para definir como os candidatos de preenchimento automático são exibidos.

private void Form1_Load(object sender, EventArgs e)
{
    // Create the list to use as the custom source. 
    var source = new AutoCompleteStringCollection();
    source.AddRange(new string[]
                    {
                        "January",
                        "February",
                        "March",
                        "April",
                        "May",
                        "June",
                        "July",
                        "August",
                        "September",
                        "October",
                        "November",
                        "December"
                    });

    // Create and initialize the text box.
    var textBox = new TextBox
                  {
                      AutoCompleteCustomSource = source,
                      AutoCompleteMode = 
                          AutoCompleteMode.SuggestAppend,
                      AutoCompleteSource =
                          AutoCompleteSource.CustomSource,
                      Location = new Point(20, 20),
                      Width = ClientRectangle.Width - 40,
                      Visible = true
                  };

    // Add the text box to the form.
    Controls.Add(textBox);
}

Comentários

Use as AutoCompleteCustomSourcepropriedades , AutoCompleteModee AutoCompleteSource para criar um TextBox 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 TextBox 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 como CustomSource para usar AutoCompleteCustomSource.

Você deve usar as AutoCompleteMode propriedades e AutoCompleteSource juntas.

Nota

AutoCompleteSource não funciona em controles multilinha TextBox .

Nota

O sistema operacional pode limitar o número de cadeias de caracteres personalizadas que podem ser exibidas de uma só vez.

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Confira também