TextBox.AutoCompleteSource Proprietà

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

Valore della proprietà

Uno dei valori di AutoCompleteSource. Le opzioni sono AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource e None. Il valore predefinito è None.

Attributi

BrowsableAttribute TypeConverterAttribute

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come usare una raccolta come origine personalizzata completa automaticamente per un TextBox controllo. In questo esempio vengono eseguite le operazioni seguenti:

• Usa la AutoCompleteSource proprietà per consentire al TextBox controllo di accettare un'origine personalizzata per il comportamento di completamento automatico.

• Usa la AutoCompleteCustomSource proprietà per impostare l'elenco personalizzato di valori.

• Usa la AutoCompleteMode proprietà per impostare la modalità di visualizzazione dei candidati per il completamento automatico.

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

Commenti

Usare le AutoCompleteCustomSourceproprietà , AutoCompleteModee AutoCompleteSource per creare un TextBox oggetto che completa automaticamente le stringhe di input confrontando il prefisso immesso con i prefissi di tutte le stringhe in un'origine gestita. Ciò è utile per TextBox i controlli in cui gli URL, gli indirizzi, i nomi di file o i comandi verranno immessi di frequente.

L'uso della AutoCompleteCustomSource proprietà è facoltativo, ma è necessario impostare la AutoCompleteSource proprietà su CustomSource per usare AutoCompleteCustomSource.

È necessario utilizzare insieme le AutoCompleteMode proprietà e AutoCompleteSource .

Si applica a

Vedi anche

• AutoCompleteCustomSource
• AutoCompleteMode