TextBox.AutoCompleteCustomSource Egenskap

Definition

Hämtar eller anger en anpassad StringCollection som ska användas när egenskapen AutoCompleteSource är inställd på 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

Egenskapsvärde

A StringCollection att använda med AutoCompleteSource.

Attribut

Exempel

I följande kodexempel visas hur du använder en samling som automatisk komplettering av anpassad källa för en TextBox kontroll. Det här exemplet gör följande:

  • AutoCompleteSource Använder egenskapen för att aktivera TextBox kontrollen för att acceptera en anpassad källa för dess automatiska kompletteringsbeteende.

  • Använder egenskapen AutoCompleteCustomSource för att ange den anpassade listan med värden.

  • Använder egenskapen AutoCompleteMode för att ange hur de automatiskt kompletta kandidaterna ska visas.

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

Kommentarer

AutoCompleteCustomSourceAnvänd egenskaperna , AutoCompleteModeoch AutoCompleteSource för att skapa en TextBox som automatiskt slutför indatasträngar genom att jämföra prefixet som anges med prefixet för alla strängar i en underhållen källa. Detta är användbart för TextBox kontroller där URL:er, adresser, filnamn eller kommandon anges ofta.

Det är valfritt att använda AutoCompleteCustomSource egenskapen, men du måste ange AutoCompleteSource egenskapen till CustomSource för att kunna använda AutoCompleteCustomSource.

Du måste använda AutoCompleteMode egenskaperna och AutoCompleteSource tillsammans.

Note

Operativsystemet kan begränsa antalet anpassade strängar som kan visas samtidigt.

Gäller för

Se även