TextBox.AutoCompleteCustomSource Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

TextBox.cs

Mendapatkan atau mengatur kustom StringCollection yang akan digunakan saat AutoCompleteSource properti diatur ke 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

Nilai Properti

AutoCompleteStringCollection

untuk StringCollection digunakan dengan AutoCompleteSource.

Atribut

BrowsableAttribute

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

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

Lihat juga

• AutoCompleteSource
• AutoCompleteMode