TextBox.AutoCompleteSource Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

TextBox.cs

Ottiene o imposta un valore che specifica l'origine delle stringhe complete utilizzate 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, HistoryListRecentlyUsedList, , CustomSourcee None. Il valore predefinito è None.

Attributi

BrowsableAttribute TypeConverterAttribute

Eccezioni

InvalidEnumArgumentException

Il valore specificato non è uno dei valori di 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 oggetto TextBox 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 vengono immessi frequentemente URL, indirizzi, nomi di file o comandi.

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

È necessario utilizzare insieme le AutoCompleteMode proprietà e AutoCompleteSource .

Annotazioni

AutoCompleteSource non funziona sui controlli su più righe TextBox .

Annotazioni

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

Vedi anche

• AutoCompleteCustomSource
• AutoCompleteMode