TextBox.AutoCompleteCustomSource Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un oggetto StringCollection personalizzato da usare quando la proprietà AutoCompleteSource è impostata su CustomSource.

public:
 property System::Windows::Forms::AutoCompleteStringCollection ^ AutoCompleteCustomSource { System::Windows::Forms::AutoCompleteStringCollection ^ get(); void set(System::Windows::Forms::AutoCompleteStringCollection ^ value); };

[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.AutoCompleteStringCollection AutoCompleteCustomSource { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.AutoCompleteCustomSource : System.Windows.Forms.AutoCompleteStringCollection with get, set

Public Property AutoCompleteCustomSource As AutoCompleteStringCollection

Valore della proprietà

AutoCompleteStringCollection

Oggetto StringCollection da usare con AutoCompleteSource.

Attributi

BrowsableAttribute

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

Il sistema operativo potrebbe limitare il numero di stringhe personalizzate che è possibile visualizzare contemporaneamente.

Vedi anche

• AutoCompleteSource
• AutoCompleteMode