TextBox.AutoCompleteSource Właściwość

Definicja

Pobiera lub ustawia wartość określającą Źródło kompletnych ciągów używanych do automatycznego uzupełniania.Gets or sets a value specifying the source of complete strings used for automatic completion.

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; }
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set
Public Property AutoCompleteSource As AutoCompleteSource

Wartość właściwości

Jedna z wartości AutoCompleteSource.One of the values of AutoCompleteSource. Dostępne są opcje AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSourcei None.The options are AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource, and None. Wartość domyślna to None.The default is None.

Atrybuty

Wyjątki

Określona wartość nie jest jedną z wartości AutoCompleteSource.The specified value is not one of the values of AutoCompleteSource.

Przykłady

Poniższy przykład kodu demonstruje, jak używać kolekcji jako autouzupełniania źródła niestandardowego dla formantu TextBox.The following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. Ten przykład wykonuje następujące czynności:This example does the following:

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

Uwagi

Użyj właściwości AutoCompleteCustomSource, AutoCompleteModei AutoCompleteSource, aby utworzyć TextBox, które automatycznie uzupełnia ciągi wejściowe przez porównanie prefiksu wprowadzanego do prefiksów wszystkich ciągów w obsługiwanym źródle.Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. Jest to przydatne w przypadku formantów TextBox, w których są często wprowadzane adresy URL, adresy, nazwy plików lub polecenia.This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.

Użycie właściwości AutoCompleteCustomSource jest opcjonalne, ale należy ustawić właściwość AutoCompleteSource na CustomSource, aby można było użyć AutoCompleteCustomSource.The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

Należy używać jednocześnie właściwości AutoCompleteMode i AutoCompleteSource.You must use the AutoCompleteMode and AutoCompleteSource properties together.

Uwaga

AutoCompleteSource nie działa na kontrolkach TextBox wielowierszowych.AutoCompleteSource does not work on multiline TextBox controls.

Uwaga

System operacyjny może ograniczyć liczbę ciągów niestandardowych, które mogą być wyświetlane jednocześnie.The operating system might limit the number of custom strings that can be displayed at once.

Dotyczy

Zobacz też