TextBox.AutoCompleteSource Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab oder legt einen Wert fest, der die Quelle vollständiger Zeichenfolgen für die automatische Vervollständigung angibt.

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

Eigenschaftswert

AutoCompleteSource

Einer der Werte von AutoCompleteSource. Optionen: AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource und None. Der Standardwert ist None.

Attribute

BrowsableAttribute TypeConverterAttribute

Ausnahmen

InvalidEnumArgumentException

Der angegebene Wert ist keiner der AutoCompleteSource-Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung als benutzerdefinierte Quelle für die automatische Vervollständigung für ein TextBox Steuerelement verwendet wird. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:

• Verwendet die AutoCompleteSource -Eigenschaft, um das TextBox Steuerelement zu aktivieren, um eine benutzerdefinierte Quelle für sein Verhalten bei der automatischen Vervollständigung zu akzeptieren.

• Verwendet die AutoCompleteCustomSource -Eigenschaft, um die benutzerdefinierte Liste der Werte festzulegen.

• Verwendet die AutoCompleteMode -Eigenschaft, um festzulegen, wie die Kandidaten für die automatische Vervollständigung angezeigt werden.

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

Hinweise

Verwenden Sie die AutoCompleteCustomSourceEigenschaften , AutoCompleteModeund, AutoCompleteSource um ein TextBox zu erstellen, das Eingabezeichenfolgen automatisch abschließt, indem das eingegebene Präfix mit den Präfixen aller Zeichenfolgen in einer verwalteten Quelle verglichen wird. Dies ist nützlich für TextBox Steuerelemente, in denen häufig URLs, Adressen, Dateinamen oder Befehle eingegeben werden.

Die Verwendung der AutoCompleteCustomSource -Eigenschaft ist optional. Sie müssen die AutoCompleteSource -Eigenschaft jedoch auf CustomSource festlegen, um zu verwenden AutoCompleteCustomSource.

Sie müssen die AutoCompleteMode Eigenschaften und AutoCompleteSource zusammen verwenden.

Hinweis

AutoCompleteSource funktioniert nicht bei mehrlineigen TextBox Steuerelementen.

Hinweis

Das Betriebssystem kann die Anzahl der benutzerdefinierten Zeichenfolgen einschränken, die gleichzeitig angezeigt werden können.

Weitere Informationen

• AutoCompleteCustomSource
• AutoCompleteMode