Lire en anglais

Partager via

option

Invite l’utilisateur à sélectionner un élément dans une liste de choix à caractère unique dans un programme de traitement par lots, puis retourne l’index du choix sélectionné. Si elle est utilisée sans paramètres, choix affiche les choix par défaut Y et N.

Syntaxe

choice [/c [<choice1><choice2><…>]] [/n] [/cs] [/t <timeout> /d <choice>] [/m <text>]

Paramètres

Paramètre Description
/c <choice1><choice2><…> Spécifie la liste des choix à créer. Les choix valides incluent a-z, A-Z, 0-9 et caractères ASCII étendus (128-254). La liste par défaut est YN, qui est affichée en tant que [Y,N]?.
/n Masque la liste des choix, bien que les choix soient toujours activés et que le texte du message (s’il est spécifié par /m) s’affiche toujours.
/Cs Spécifie que les choix respectent la casse. Par défaut, les choix ne respectent pas la casse.
/t <timeout> Spécifie le nombre de secondes à suspendre avant d’utiliser le choix par défaut spécifié par /d. Les valeurs acceptables sont comprises entre 0 et 9999. Si /t est défini sur 0, choix ne s’interrompt pas avant de retourner le choix par défaut.
/d <choice> Spécifie le choix par défaut à utiliser après avoir attendu le nombre de secondes spécifié par /t. Le choix par défaut doit figurer dans la liste des choix spécifiés par /c.
/m <text> Spécifie un message à afficher avant la liste des choix. Si /m n’est pas spécifié, seule l’invite de choix s’affiche.
/? Affiche l’aide à l’invite de commandes.

Remarques

  • La variable d’environnement ERRORLEVEL est définie sur l’index de la clé que l’utilisateur sélectionne dans la liste des choix. Le premier choix dans la liste retourne une valeur de 1, la seconde une valeur de 2, et ainsi de suite. Si l’utilisateur appuie sur une touche qui n’est pas un choix valide, choix sonne un bip d’avertissement.

  • Si choix détecte une condition d’erreur, elle retourne une valeur ERRORLEVEL de 255. Si l’utilisateur appuie sur CTRL+BREAK ou Ctrl+C, choix retourne une valeur ERRORLEVEL de 0.

Notes

Lorsque vous utilisez valeurs ERRORLEVEL dans un programme de traitement par lots, vous devez les répertorier dans l’ordre décroissant.

Exemples

Pour présenter les choix Y, Net C, tapez la ligne suivante dans un fichier de commandes :

choice /c ync

L’invite suivante s’affiche lorsque le fichier batch exécute la commande choix :

[Y,N,C]?

Pour masquer les choix Y, Net C, mais affichez le texte Oui, Nonou Continuer, tapez la ligne suivante dans un fichier de commandes :

choice /c ync /n /m "Yes, No, or Continue?"

Notes

Si vous utilisez le paramètre /n, mais n’utilisez pas /m, l’utilisateur n’est pas invité quand choix attend l’entrée.

Pour afficher le texte et les options utilisées dans les exemples précédents, tapez la ligne suivante dans un fichier de commandes :

choice /c ync /m "Yes, No, or Continue"

Pour définir une limite de temps de cinq secondes et spécifier N comme valeur par défaut, tapez la ligne suivante dans un fichier de commandes :

choice /c ync /t 5 /d n

Notes

Dans cet exemple, si l’utilisateur n’appuie pas sur une touche dans les cinq secondes, choix sélectionne N par défaut et retourne une valeur d’erreur de 2. Sinon, choix retourne la valeur correspondant au choix de l’utilisateur.