Cette documentation est archivée et n’est pas conservée.

ComboBox.AutoCompleteMode, propriété

Mise à jour : Juillet 2008

Obtient ou définit une option qui contrôle le fonctionnement de la saisie semi-automatique pour ComboBox.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

[BrowsableAttribute(true)]
public AutoCompleteMode AutoCompleteMode { get; set; }
/** @property */
/** @attribute BrowsableAttribute(true) */
public AutoCompleteMode get_AutoCompleteMode()
/** @property */
/** @attribute BrowsableAttribute(true) */
public  void set_AutoCompleteMode(AutoCompleteMode value)

public function get AutoCompleteMode () : AutoCompleteMode
public function set AutoCompleteMode (value : AutoCompleteMode)

Valeur de propriété

Type : System.Windows.Forms.AutoCompleteMode

Une des valeurs de AutoCompleteMode. Les valeurs sont Append, None, Suggest et SuggestAppend. La valeur par défaut est None.

ExceptionCondition
InvalidEnumArgumentException

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

Utilisez les propriétés AutoCompleteCustomSource, AutoCompleteMode et AutoCompleteSource pour créer un 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 d'une source gérée. Cela s'avère utile pour les contrôles ComboBox dans lesquels des URL, des adresses, des noms de fichiers ou des commandes seront fréquemment entrés. S'il y a des entrées en double dans la source maintenue, la saisie semi-automatique se comporte de façon imprévisible.

Si vous affectez à ComboBoxStyle la valeur DropDownList, la liste s'affiche uniquement si AutoCompleteMode est Suggest ou SuggestAppend.

L'utilisation de la propriété AutoCompleteCustomSource est facultative, mais vous devez affecter la valeur CustomSource à la propriété AutoCompleteSource pour utiliser AutoCompleteCustomSource.

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

Avec AutoCompleteMode définie à SuggestAppend et AutoCompleteSource définie à ListItems, le comportement est le suivant :

  • Si la liste de chaînes est vide, une pression sur la touche RETOUR ARRIÈRE ou SUPPRESSION n'a aucun effet.

  • Si l'utilisateur appuie sur la touche RETOUR ARRIÈRE pendant 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.

  • Si l'utilisateur appuie sur la touche RETOUR ARRIÈRE pendant plus d'une seconde, le premier élément est sélectionné.

  • Si l'utilisateur appuie sur la touche SUPPRESSION, le premier élément est sélectionné.

Remarque :

Le système d'exploitation peut limiter le nombre de chaînes personnalisées pouvant être affichées simultanément. 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 qui est comprise.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Date

Historique

Raison

Juillet 2008

Révision de la section Valeur de propriété pour répertorier les valeurs AutoCompleteMode correctes.

Commentaires client.

Afficher: