TextBox.AutoCompleteMode Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft eine Option ab oder legt eine Option fest, die die Funktionsweise der automatischen Vervollständigung für TextBox steuert.

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

Eigenschaftswert

AutoCompleteMode

Einer der Werte von AutoCompleteMode. Im Folgenden sind die Werte aufgeführt.

Append
Fügt die verbleibenden Zeichen der am ehesten in Frage kommenden Zeichenfolge an die vorhandenen Zeichen an und markiert die angehängten Zeichen.

Suggest
Zeigt die dem Bearbeitungssteuerelement zugeordnete Hilfsdropdownliste an. Diese Dropdownliste wird mit einer oder mehreren vorgeschlagenen Abschlusszeichenfolgen aufgefüllt.

SuggestAppend
Fügt die beiden Optionen Suggest und Append an.

None
Deaktiviert den automatischen Abschluss. Dies ist die Standardoption.

Attribute
BrowsableAttribute

Ausnahmen

InvalidEnumArgumentException

Der angegebene Wert ist keiner der AutoCompleteMode-Werte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie eine Auflistung als benutzerdefinierte Quelle für ein TextBox Steuerelement verwenden. 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 ihr automatisches Vollständiges Verhalten zu akzeptieren.

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

  • Verwendet die Eigenschaft, um festzulegen, wie die AutoCompleteMode automatisch abgeschlossenen Kandidaten 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 AutoCompleteCustomSourceAutoCompleteModeEigenschaften , und AutoCompleteSource erstellen Sie eineTextBox, die Eingabezeichenfolgen automatisch abgeschlossen, indem Sie das Präfix vergleichen, das in die Präfixe aller Zeichenfolgen in einer verwalteten Quelle eingegeben wird. Dies ist nützlich für Steuerelemente, in TextBox denen URLs, Adressen, Dateinamen oder Befehle häufig eingegeben werden.

Die Verwendung der AutoCompleteCustomSource Eigenschaft ist optional, aber Sie müssen die AutoCompleteSource Eigenschaft CustomSource so festlegen, dass sie verwendet AutoCompleteCustomSourcewerden soll.

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

Hinweis

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

Gilt für

Siehe auch