Compartilhar via

TextBox.AutoCompleteMode Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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. A seguir são mostrados os valores.

Append
Acrescenta o restante da cadeia de caracteres candidata mais provável aos caracteres existentes, realçando os caracteres acrescentados.

Suggest
Exibe a lista suspensa auxiliar associada ao controle de edição. Essa lista suspensa é populada com uma ou mais cadeias de caracteres de conclusão sugeridas.

SuggestAppend
Acrescenta as opções e Append as opçõesSuggest.

None
Desabilita a conclusão automática. Este é o padrão.

Atributos
BrowsableAttribute

Exceções

InvalidEnumArgumentException

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

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);
}

Private Sub Form1_Load(ByVal sender As System.Object, _
                       ByVal e As System.EventArgs) Handles MyBase.Load

    ' Create the list to use as the custom source.
    Dim MySource As New AutoCompleteStringCollection()
    MySource.AddRange(New String() _
                        { _
                            "January", _
                            "February", _
                            "March", _
                            "April", _
                            "May", _
                            "June", _
                            "July", _
                            "August", _
                            "September", _
                            "October", _
                            "November", _
                            "December" _
                        })

    ' Create and initialize the text box.
    Dim MyTextBox As New TextBox()
    With MyTextBox
        .AutoCompleteCustomSource = MySource
        .AutoCompleteMode = AutoCompleteMode.SuggestAppend
        .AutoCompleteSource = AutoCompleteSource.CustomSource
        .Location = New Point(20, 20)
        .Width = Me.ClientRectangle.Width - 40
        .Visible = True
    End With

    ' Add the text box to the form.
    Me.Controls.Add(MyTextBox)
End Sub

Comentários

Use o AutoCompleteCustomSource, AutoCompleteModee AutoCompleteSource as propriedades 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 para CustomSource usar AutoCompleteCustomSource.

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

Observação

O sistema operacional pode limitar o número de cadeias de caracteres personalizadas que ele pode exibir ao mesmo tempo.

Aplica-se a

Confira também