TextBox.AutoCompleteSource Propriété

Définition

Obtient ou définit une valeur qui spécifie la source de chaînes complètes utilisées pour la saisie semi-automatique.Gets or sets a value specifying the source of complete strings used for automatic completion.

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; }
member this.AutoCompleteSource : System.Windows.Forms.AutoCompleteSource with get, set
Public Property AutoCompleteSource As AutoCompleteSource

Valeur de propriété

Une des valeurs de AutoCompleteSource.One of the values of AutoCompleteSource. Les options sont AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource et None.The options are AllSystemSources, AllUrl, FileSystem, HistoryList, RecentlyUsedList, CustomSource, and None. La valeur par défaut est None,The default is None.

Attributs

Exceptions

La valeur spécifiée ne fait pas partie des valeurs de AutoCompleteSource.The specified value is not one of the values of AutoCompleteSource.

Exemples

L’exemple de code suivant montre comment utiliser une collection comme source personnalisée de saisie semi-automatique pour un contrôle de TextBox.The following code example demonstrates how to use a collection as the auto-complete custom source for a TextBox control. L'exemple réalise les actions suivantes :This example does the following:

  • Utilise la propriété AutoCompleteSource pour permettre au contrôle TextBox d’accepter une source personnalisée pour son comportement de saisie semi-automatique.Uses the AutoCompleteSource property to enable the TextBox control to accept a custom source for its auto-complete behavior.

  • Utilise la propriété AutoCompleteCustomSource pour définir la liste personnalisée de valeurs.Uses the AutoCompleteCustomSource property to set the custom list of values.

  • Utilise la propriété AutoCompleteMode pour définir le mode d’affichage des candidats à la saisie semi-automatique.Uses the AutoCompleteMode property to set how the auto-complete candidates are displayed.

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 propriétés AutoCompleteCustomSource, AutoCompleteModeet AutoCompleteSource pour créer une TextBox qui complète 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.Use the AutoCompleteCustomSource, AutoCompleteMode, and AutoCompleteSource properties to create a TextBox that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. Cela est utile pour TextBox contrôles dans lesquels des URL, des adresses, des noms de fichiers ou des commandes sont fréquemment entrés.This is useful for TextBox controls in which URLs, addresses, file names, or commands will be frequently entered.

L’utilisation de la propriété AutoCompleteCustomSource est facultative, mais vous devez affecter à la propriété AutoCompleteSource la valeur CustomSource afin d’utiliser AutoCompleteCustomSource.The use of the AutoCompleteCustomSource property is optional, but you must set the AutoCompleteSource property to CustomSource in order to use AutoCompleteCustomSource.

Vous devez utiliser les propriétés AutoCompleteMode et AutoCompleteSource ensemble.You must use the AutoCompleteMode and AutoCompleteSource properties together.

Notes

AutoCompleteSource ne fonctionne pas sur les contrôles de TextBox multiligne.AutoCompleteSource does not work on multiline TextBox controls.

Notes

Le système d’exploitation peut limiter le nombre de chaînes personnalisées qui peuvent être affichées à la fois.The operating system might limit the number of custom strings that can be displayed at once.

S’applique à

Voir aussi