TextBox.AutoCompleteCustomSource Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

TextBox.cs

Dient zum Abrufen oder Festlegen eines benutzerdefinierten StringCollection Werts, der verwendet werden soll, wenn die AutoCompleteSource Eigenschaft auf 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

Eigenschaftswert

AutoCompleteStringCollection

A StringCollection für die Verwendung mit AutoCompleteSource.

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Auflistung als benutzerdefinierte Quelle 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 autovervollständigen Verhalten zu akzeptieren.

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

• Verwendet die AutoCompleteMode Eigenschaft, um festzulegen, wie die 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 AutoCompleteCustomSourceEigenschaften , AutoCompleteModeum AutoCompleteSource ein TextBox Objekt zu erstellen, das Eingabezeichenfolgen automatisch abschließt, indem Sie das Präfix vergleichen, das mit den Präfixen aller Zeichenfolgen in einer verwalteten Quelle eingegeben wird. Dies ist nützlich für TextBox Steuerelemente, in denen URLs, Adressen, Dateinamen oder Befehle häufig eingegeben werden.

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

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

Hinweis

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

Weitere Informationen

• AutoCompleteSource
• AutoCompleteMode