TextBox.AutoCompleteMode Egenskap

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

Egenskapsvärde

Ett av värdena AutoCompleteModeför . Följande är värdena.

Append Lägger till resten av den mest sannolika kandidatsträngen till de befintliga tecknen och markerar de bifogade tecknen.

Suggest Visar den extra listruta som är associerad med redigeringskontrollen. Den här listrutan fylls i med en eller flera föreslagna slutförandesträngar.

SuggestAppend Lägger till både Suggest och Append alternativ.

None Inaktiverar automatisk slutförande. Det här är standardinställningen.

Attribut

BrowsableAttribute

Undantag

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.

Se även

• AutoCompleteCustomSource
• AutoCompleteSource