TextBox.AutoCompleteMode Propriedade
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 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
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
O valor especificado não é um dos valores de AutoCompleteMode.
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
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.
Nota
O sistema operacional pode limitar o número de cadeias de caracteres personalizadas que ele pode exibir ao mesmo tempo.