TextBox.AutoCompleteSource Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur qui spécifie la source de chaînes complètes utilisées pour la saisie semi-automatique.

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

Valeur de propriété

AutoCompleteSource

Une des valeurs de AutoCompleteSource. Les options sont AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource et None. La valeur par défaut est None.

Attributs

BrowsableAttribute TypeConverterAttribute

Exceptions

InvalidEnumArgumentException

La valeur spécifiée ne fait pas partie des valeurs de AutoCompleteSource.

Exemples

L’exemple de code suivant montre comment utiliser une collection comme source personnalisée de saisie semi-automatique d’un TextBox contrôle. L'exemple réalise les actions suivantes :

• Utilise la AutoCompleteSource propriété pour permettre au TextBox contrôle d’accepter une source personnalisée pour son comportement de saisie semi-automatique.

• Utilise la AutoCompleteCustomSource propriété pour définir la liste personnalisée de valeurs.

• Utilise la AutoCompleteMode propriété pour définir la façon dont les candidats à la saisie semi-automatique sont affichés.

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

Remarques

Utilisez les AutoCompleteCustomSourcepropriétés , AutoCompleteModeet AutoCompleteSource pour créer un TextBox qui termine automatiquement les chaînes d’entrée en comparant le préfixe entré aux préfixes de toutes les chaînes dans une source gérée. Cela est utile pour TextBox les contrôles dans lesquels les URL, les adresses, les noms de fichiers ou les commandes sont fréquemment entrés.

L’utilisation de la AutoCompleteCustomSource propriété est facultative, mais vous devez définir la AutoCompleteSource propriété CustomSource sur pour pouvoir utiliser AutoCompleteCustomSource.

Vous devez utiliser les AutoCompleteMode propriétés et AutoCompleteSource ensemble.

Notes

AutoCompleteSource ne fonctionne pas sur les contrôles multilignes TextBox .

Notes

Le système d’exploitation peut limiter le nombre de chaînes personnalisées qui peuvent être affichées simultanément.

Voir aussi

• AutoCompleteCustomSource
• AutoCompleteMode