ComboBox.AutoCompleteMode Propriété

Définition

Obtient ou définit une option qui contrôle le fonctionnement de la saisie semi-automatique pour ComboBox.Gets or sets an option that controls how automatic completion works for the ComboBox.

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

Valeur de propriété

Une des valeurs de AutoCompleteMode.One of the values of AutoCompleteMode. Les valeurs sont Append, None, Suggest et SuggestAppend.The values are Append, None, Suggest, and SuggestAppend. 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 AutoCompleteMode.The specified value is not one of the values of AutoCompleteMode.

Remarques

Utilisez les propriétés AutoCompleteCustomSource, AutoCompleteModeet AutoCompleteSource pour créer une ComboBox 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 ComboBox 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 ComboBox contrôles dans lesquels des URL, des adresses, des noms de fichiers ou des commandes sont fréquemment entrés.This is useful for ComboBox controls in which URLs, addresses, file names, or commands will be frequently entered. S’il existe des entrées en double dans la source gérée, la saisie semi-automatique se comporte de manière imprévisible.If there are duplicate entries in the maintained source, automatic completion behaves unpredictably.

Si vous affectez à ComboBoxStyle la valeur DropDownList, la liste s’affiche uniquement si AutoCompleteMode est Suggest ou SuggestAppend.If you set ComboBoxStyle to DropDownList, the list displays only if AutoCompleteMode is Suggest or SuggestAppend.

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.

Avec AutoCompleteMode défini sur SuggestAppend et AutoCompleteSource défini sur ListItems, le comportement est le suivant :With AutoCompleteMode set to SuggestAppend and AutoCompleteSource set to ListItems, the behavior is as follows:

  • Si la liste de chaînes est vide, le fait d’appuyer sur la touche Retour arrière ou supprimer n’a aucun effet.If the list of strings is empty, pressing the BACKSPACE or DELETE key does nothing.

  • Si la touche Retour arrière est enfoncée en moins d’une seconde, l’élément précédent est sélectionné ou rien n’est sélectionné si la liste de chaînes est vide.If the BACKSPACE key is pressed in less than one second, the previous item is selected, or nothing is selected if the list of string is empty.

  • Si la touche Retour arrière est enfoncée en moins d’une seconde, le premier élément est sélectionné.If the BACKSPACE key is pressed in more than one second, the first item is selected.

  • Si vous appuyez sur la touche Suppr, le premier élément est sélectionné.If the DELETE key is pressed, the first item is selected.

Notes

Le système d’exploitation peut limiter le nombre de chaînes personnalisées qu’il peut afficher à la fois.The operating system might limit the number of custom strings that it can display at once. Pour les chaînes qui contiennent une barre oblique (/) ou une barre oblique inverse (\), la saisie semi-automatique ajoute tous les caractères uniquement jusqu’à la barre oblique et y compris.For strings that contain a forward slash (/) or backward slash (\), automatic completion appends all characters only up to and including the slash.

S’applique à

Voir aussi