TextBox.AutoCompleteSource Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Otomatik tamamlama için kullanılan tam dizelerin kaynağını belirten bir değer alır veya ayarlar.

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

Özellik Değeri

AutoCompleteSource

değerlerinden AutoCompleteSourcebiri. Seçenekler , , , , , HistoryListRecentlyUsedList, CustomSourceve None'dırAllSystemSources. FileSystemAllUrl Varsayılan değer: None.

Öznitelikler

BrowsableAttribute TypeConverterAttribute

Özel durumlar

InvalidEnumArgumentException

Belirtilen değer değerinin değerlerinden AutoCompleteSourcebiri değil.

Örnekler

Aşağıdaki kod örneği, bir koleksiyonun bir denetim için TextBox otomatik tamamlama özel kaynağı olarak nasıl kullanılacağını gösterir. Bu örnek aşağıdakileri yapar:

• Denetimin AutoCompleteSource otomatik tamamlama davranışı için özel bir kaynağı kabul etmesini sağlamak TextBox için özelliğini kullanır.

• AutoCompleteCustomSource Özel değer listesini ayarlamak için özelliğini kullanır.

• AutoCompleteMode Otomatik tamamlama adaylarının nasıl görüntüleneceğini ayarlamak için özelliğini kullanır.

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

Açıklamalar

Girilmekte olan ön eki bakımlı AutoCompleteCustomSourcebir TextBox kaynaktaki tüm dizelerin ön ekleriyle karşılaştırarak giriş dizelerini otomatik olarak tamamlayan bir oluşturmak için , AutoCompleteModeve AutoCompleteSource özelliklerini kullanın. Bu, URL'lerin, adreslerin, dosya adlarının veya komutların sık girileceği denetimler için TextBox kullanışlıdır.

özelliğinin AutoCompleteCustomSource kullanımı isteğe bağlıdır, ancak özelliğini kullanmak AutoCompleteCustomSourceiçin olarak ayarlamanız AutoCompleteSource CustomSource gerekir.

ve AutoCompleteSource özelliklerini birlikte kullanmanız AutoCompleteMode gerekir.

Not

AutoCompleteSource çok satırlı TextBox denetimlerde çalışmaz.

Not

İşletim sistemi, aynı anda görüntülenebilen özel dizelerin sayısını sınırlayabilir.

Ayrıca bkz.

• AutoCompleteCustomSource
• AutoCompleteMode