TextBox.AutoCompleteCustomSource Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft ab oder legt fest, welche benutzerdefinierte StringCollection verwendet werden soll, wenn die AutoCompleteSource-Eigenschaft auf CustomSource festgelegt ist.

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

Eine StringCollection, die mit AutoCompleteSource verwendet wird.

Attribute: BrowsableAttribute

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

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

Gilt für:

Freigeben über