TextBox.AutoCompleteMode Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví možnost, která řídí, jak automatické dokončování funguje pro .TextBox

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

Hodnota vlastnosti

AutoCompleteMode

Jedna z hodnot AutoCompleteMode. Níže jsou uvedené hodnoty.

Append
Připojí zbytek nejpravděpodobnějšího kandidátského řetězce k existujícím znakům a zvýrazní připojené znaky.

Suggest
Zobrazí pomocný rozevírací seznam přidružený k ovládacímu prvku pro úpravy. Tento rozevírací seznam se naplní jedním nebo více navrhovanými řetězci dokončení.

SuggestAppend
Připojí obě Suggest možnosti a Append možnosti.

None
Zakáže automatické dokončování. Tato možnost je výchozí.

Atributy

BrowsableAttribute

Výjimky

InvalidEnumArgumentException

Zadaná hodnota není jednou z hodnot AutoCompleteMode.

Příklady

Následující příklad kódu ukazuje použití kolekce jako automatického dokončování vlastního zdroje pro TextBox ovládací prvek. Tento příklad provede následující:

• 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í , AutoCompleteModea AutoCompleteSource vlastnosti vytvořitTextBox, 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 musíte vlastnost nastavit AutoCompleteSource tak, aby CustomSource bylo možné použít AutoCompleteCustomSource.

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

Poznámka

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

Viz také

• AutoCompleteCustomSource
• AutoCompleteSource