TextBox.AutoCompleteSource Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví hodnotu určující zdroj úplných řetězců používaných pro automatické dokončování.

public:
 property System::Windows::Forms::AutoCompleteSource AutoCompleteSource { System::Windows::Forms::AutoCompleteSource get(); void set(System::Windows::Forms::AutoCompleteSource value); };

[System.ComponentModel.Browsable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))]
public System.Windows.Forms.AutoCompleteSource AutoCompleteSource { get; set; }

[<System.ComponentModel.Browsable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.TextBoxAutoCompleteSourceConverter))>]
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set

Public Property AutoCompleteSource As AutoCompleteSource

Hodnota vlastnosti

AutoCompleteSource

Jedna z hodnot .AutoCompleteSource Možnosti jsou AllSystemSources, AllUrl, FileSystem, HistoryListRecentlyUsedList, , CustomSourcea None. Výchozí formát je None.

Atributy

BrowsableAttribute TypeConverterAttribute

Výjimky

InvalidEnumArgumentException

Zadaná hodnota není jednou z hodnot parametru AutoCompleteSource.

Příklady

Následující příklad kódu ukazuje, jak použít kolekci jako automatické dokončování vlastního zdroje pro ovládací prvek TextBox . V tomto příkladu se provede toto:

• AutoCompleteSource Používá vlastnost k povolení TextBox ovládacího 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 Použije vlastnost k nastavení způsobu zobrazení kandidátů 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

AutoCompleteCustomSourcePomocí vlastností , AutoCompleteModea AutoCompleteSource vytvořte TextBox objekt, který automaticky dokončí vstupní řetězce porovnáním zadané předpony 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 abyste ji mohli použítAutoCompleteCustomSource, musíte ji nastavit AutoCompleteSource na CustomSource hodnotu .

Vlastnosti a AutoCompleteSource musíte použít AutoCompleteMode společně.

Poznámka

AutoCompleteSource nefunguje u víceřádkových TextBox ovládacích prvků.

Poznámka

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

Viz také

• AutoCompleteCustomSource
• AutoCompleteMode