TextBox.AutoCompleteSource Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

TextBox.cs

Mendapatkan atau menetapkan nilai yang menentukan sumber string lengkap yang digunakan untuk penyelesaian otomatis.

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

Nilai Properti

AutoCompleteSource

Salah satu nilai AutoCompleteSource. Opsinya adalah AllSystemSources, , AllUrl, HistoryListFileSystem, RecentlyUsedList, CustomSource, dan None. Defaultnya adalah None.

Atribut

BrowsableAttribute TypeConverterAttribute

Pengecualian

InvalidEnumArgumentException

Nilai yang ditentukan bukan salah satu nilai .AutoCompleteSource

Contoh

Contoh kode berikut menunjukkan cara menggunakan koleksi sebagai sumber kustom lengkapi otomatis untuk TextBox kontrol. Contoh ini melakukan hal berikut:

• AutoCompleteSource Menggunakan properti untuk mengaktifkan TextBox kontrol untuk menerima sumber kustom untuk perilaku lengkapi otomatisnya.

• AutoCompleteCustomSource Menggunakan properti untuk mengatur daftar nilai kustom.

• AutoCompleteMode Menggunakan properti untuk mengatur bagaimana kandidat lengkapi otomatis ditampilkan.

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

Keterangan

AutoCompleteCustomSourceGunakan properti , AutoCompleteMode, dan AutoCompleteSource untuk membuat TextBox yang secara otomatis menyelesaikan string input dengan membandingkan awalan yang dimasukkan ke awalan semua string dalam sumber yang dipertahankan. Ini berguna untuk TextBox kontrol di mana URL, alamat, nama file, atau perintah akan sering dimasukkan.

Penggunaan AutoCompleteCustomSource properti bersifat opsional, tetapi Anda harus mengatur AutoCompleteSource properti ke CustomSource untuk menggunakan AutoCompleteCustomSource.

Anda harus menggunakan AutoCompleteMode properti dan AutoCompleteSource bersama-sama.

Nota

AutoCompleteSource tidak berfungsi pada kontrol multibaris TextBox .

Nota

Sistem operasi mungkin membatasi jumlah string kustom yang dapat ditampilkan sekaligus.

Lihat juga

• AutoCompleteCustomSource
• AutoCompleteMode