TextBox.AutoCompleteMode Propriété

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

Valeur de propriété

AutoCompleteMode

Une des valeurs de AutoCompleteMode. Les valeurs sont les suivantes.

Append
Ajoute le reste de la chaîne des candidats les plus probables aux caractères existants, en mettant en surbrillance les caractères ajoutés.

Suggest
Affiche la liste déroulante auxiliaire associée au contrôle d'édition. Cette liste déroulante est remplie avec une ou plusieurs chaînes de saisie semi-automatique suggérées.

SuggestAppend
Ajoute à la fois Suggest et les options Append.

None
Désactive la saisie semi-automatique. Il s’agit de la valeur par défaut.

Attributs

BrowsableAttribute

Exceptions

Exemples

L’exemple de code suivant montre comment utiliser une collection comme source personnalisée de saisie semi-automatique pour 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 des valeurs.

• Utilise la propriété pour définir l’affichage AutoCompleteMode des candidats de saisie semi-automatique.

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 et AutoCompleteSource les AutoCompleteCustomSourcepropriétés AutoCompleteModepour créer une TextBox chaîne d’entrée qui termine automatiquement les chaînes d’entrée en comparant le préfixe entré aux préfixes de toutes les chaînes d’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ées.

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

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

S’applique à

Voir aussi

• AutoCompleteCustomSource
• AutoCompleteSource