Condividi tramite

TextBox.AutoCompleteSource Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta un valore che specifica l'origine delle stringhe complete usate per il completamento automatico.

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à

AutoCompleteSource

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

Attributi
BrowsableAttribute TypeConverterAttribute

Eccezioni

InvalidEnumArgumentException

Il valore specificato non è uno dei valori dell'oggetto AutoCompleteSource.

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 .

Nota

AutoCompleteSource non funziona sui controlli multilinea TextBox .

Nota

Il sistema operativo potrebbe limitare il numero di stringhe personalizzate che possono essere visualizzate contemporaneamente.

Si applica a

Vedi anche