TextBox.AutoCompleteSource 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 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)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))]
public System.Windows.Forms.AutoCompleteSource AutoCompleteSource { get; set; }
[<System.ComponentModel.Browsable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))>]
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set
Public Property AutoCompleteSource As AutoCompleteSource
Um dos valores de AutoCompleteSource. As opções são AllSystemSources
, AllUrl
, FileSystem
, HistoryList
, RecentlyUsedList
, CustomSource
e None
. O padrão é None
.
- Atributos
O valor especificado não é um dos valores de AutoCompleteSource.
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 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.
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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: