TextBox.AutoCompleteMode Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

otomatik tamamlamanın için TextBoxnasıl çalıştığını denetleyebilen bir seçeneği alır veya ayarlar.

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

Özellik Değeri

AutoCompleteMode

değerlerinden AutoCompleteModebiri. Değerler aşağıdadır.

Append
En olası aday dizenin geri kalanını mevcut karakterlere ekler ve eklenen karakterleri vurgular.

Suggest
Düzenleme denetimiyle ilişkili yardımcı açılan listeyi görüntüler. Bu açılan menü bir veya daha fazla önerilen tamamlama dizesiyle doldurulur.

SuggestAppend
Hem hem de Suggest Append seçeneklerini ekler.

None
Otomatik tamamlamayı devre dışı bırakır. Bu varsayılan seçenektir.

Öznitelikler
BrowsableAttribute

Özel durumlar

InvalidEnumArgumentException

Belirtilen değer değerinin değerlerinden AutoCompleteModebiri 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

İşletim sistemi, aynı anda görüntüleyebileceği özel dize sayısını sınırlayabilir.

Şunlara uygulanır

Ayrıca bkz.