TextBox.AutoCompleteMode Property

Definition

Obtém ou define uma opção que controla como o preenchimento automático funciona para o TextBox.Gets or sets an option that controls how automatic completion works for the 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; }
member this.AutoCompleteMode : System.Windows.Forms.AutoCompleteMode with get, set
Public Property AutoCompleteMode As AutoCompleteMode

Property Value

AutoCompleteMode

Um dos valores de AutoCompleteMode.One of the values of AutoCompleteMode. A seguir são mostrados os valores.The following are the values.

Append
Acrescenta o restante da cadeia de caracteres candidata mais provável aos caracteres existentes, realçando os caracteres acrescentados.Appends the remainder of the most likely candidate string to the existing characters, highlighting the appended characters.

Suggest
Exibe a lista suspensa auxiliar associada ao controle de edição.Displays the auxiliary drop-down list associated with the edit control. Essa lista suspensa é populada com uma ou mais cadeias de caracteres de conclusão sugeridas.This drop-down is populated with one or more suggested completion strings.

SuggestAppend
Acrescenta as opções Suggest e Append.Appends both Suggest and Append options.

None
Desabilita a conclusão automática.Disables automatic completion. Esse é o padrão.This is the default.

Attributes

Exceptions

O valor especificado não é um dos valores de AutoCompleteMode.The specified value is not one of the values of AutoCompleteMode.

Examples

O exemplo de código a seguir demonstra como usar uma coleção como a origem personalizada de preenchimento automático para um controle de TextBox.The following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. Este exemplo faz o seguinte:This example does the following:

  • Usa a propriedade AutoCompleteSource para habilitar o controle de TextBox para aceitar uma fonte personalizada para seu comportamento de preenchimento automático.Uses the AutoCompleteSource property to enable the TextBox control to accept a custom source for its auto-complete behavior.

  • Usa a propriedade AutoCompleteCustomSource para definir a lista de valores personalizada.Uses the AutoCompleteCustomSource property to set the custom list of values.

  • Usa a propriedade AutoCompleteMode para definir como os candidatos de preenchimento automático são exibidos.Uses the AutoCompleteMode property to set how the auto-complete candidates are displayed.

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

Remarks

Use as propriedades AutoCompleteCustomSource, AutoCompleteModee AutoCompleteSource para criar um TextBox que conclua automaticamente as cadeias de caracteres de entrada comparando o prefixo que está sendo inserido para os prefixos de todas as cadeias de caracteres em uma origem mantida.Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. Isso é útil para TextBox controles nos quais URLs, endereços, nomes de arquivo ou comandos serão inseridos com frequência.This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.

O uso da propriedade AutoCompleteCustomSource é opcional, mas você deve definir a propriedade AutoCompleteSource como CustomSource para poder usar AutoCompleteCustomSource.The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

Você deve usar as propriedades AutoCompleteMode e AutoCompleteSource juntas.You must use the AutoCompleteMode and AutoCompleteSource properties together.

Note

O sistema operacional pode limitar o número de cadeias de caracteres personalizadas que podem ser exibidas de uma vez.The operating system might limit the number of custom strings that it can display at once.

Applies to

See also