TextBox.AutoCompleteCustomSource Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

TextBox.cs

Získá nebo nastaví vlastní StringCollection použití, pokud AutoCompleteSource je vlastnost nastavena na 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

Hodnota vlastnosti

AutoCompleteStringCollection

A StringCollection pro použití s AutoCompleteSource.

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje, jak použít kolekci jako automatické dokončování vlastní zdroj pro TextBox ovládací prvek. Tento příklad provede následující:

• AutoCompleteSource Pomocí vlastnosti umožňuje ovládacímu TextBox prvku přijmout vlastní zdroj pro jeho chování automatického dokončování.

• AutoCompleteCustomSource Použije vlastnost k nastavení vlastního seznamu hodnot.

• AutoCompleteMode Pomocí vlastnosti nastaví, jak se zobrazí kandidáti automatického dokončování.

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

Poznámky

Pomocí parametru AutoCompleteCustomSource, AutoCompleteModea AutoCompleteSource vlastnosti vytvořte TextBox , který automaticky dokončí vstupní řetězce porovnáním předpony zadané s předponami všech řetězců v udržovaném zdroji. To je užitečné pro TextBox ovládací prvky, ve kterých se často zadávají adresy URL, adresy, názvy souborů nebo příkazy.

Použití AutoCompleteCustomSource vlastnosti je volitelné, ale je nutné nastavit AutoCompleteSource vlastnost pro CustomSource použití AutoCompleteCustomSource.

Vlastnosti musíte použít AutoCompleteModeAutoCompleteSource společně.

Poznámka:

Operační systém může omezit počet vlastních řetězců, které může zobrazit najednou.

Viz také

• AutoCompleteSource
• AutoCompleteMode