TextBox.AutoCompleteMode Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un'opzione che controlla la modalità di funzionamento del completamento automatico per l'oggetto 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

Valore della proprietà

AutoCompleteMode

Uno dei valori di AutoCompleteMode. Di seguito vengono illustrati i valori.

Append
Aggiunge la parte restante della stringa candidata più probabile ai caratteri esistenti ed evidenzia i caratteri aggiunti.

Suggest
Visualizza l'elenco a discesa ausiliario associato al controllo di modifica. Questo elenco viene compilato con una o più stringhe di completamento suggerite.

SuggestAppend
Accoda entrambe le opzioni Suggest e Append.

None
Disabilita il completamento automatico. Questo è il valore predefinito.

Attributi

BrowsableAttribute

Eccezioni

InvalidEnumArgumentException

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

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 abilitare il controllo per accettare un'origine TextBox personalizzata per il relativo comportamento di completamento automatico.

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

• Usa la proprietà per impostare il AutoCompleteMode modo in cui vengono visualizzati i candidati completi automaticamente.

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 ai prefissi di tutte le stringhe in un'origine gestita. Ciò è utile per TextBox i controlli in cui verranno immessi frequentemente URL, indirizzi, nomi di file o comandi.

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

È necessario usare le AutoCompleteMode proprietà e AutoCompleteSource insieme.

Nota

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

Vedi anche

• AutoCompleteCustomSource
• AutoCompleteSource