choice
Invite l’utilisateur à sélectionner un élément dans une liste de choix de caractères dans un fichier de commandes, puis renvoie l’index du choix sélectionné. S’il est utilisé sans paramètres, choice 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 sont les caractères a-z, A-Z, 0-9 et les caractères ASCII étendus (128-254). La liste par défaut est YN, qui s’affiche au format [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) soit toujours affiché. |
| /cs | Spécifie que les choix respectent la casse. Par défaut, les requêtes ne sont pas sensibles à la casse. |
/t <timeout> |
Spécifie le nombre de secondes de pause 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, choice ne fait pas de pause avant de renvoyer 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. |
Notes
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 renvoie la valeur
1, le deuxième la valeur2, etc. Si l’utilisateur appuie sur une touche qui n’est pas un choix valide, choice émet un signal sonore d’avertissement.Si choice détecte une condition d’erreur, il renvoie la valeur ERRORLEVEL
255. Si l’utilisateur appuie sur Ctrl+Pause ou Ctrl+C, choice renvoie la valeur ERRORLEVEL0.
Notes
Quand vous utilisez des valeurs ERRORLEVEL dans un fichier de commandes, vous devez les lister dans l’ordre décroissant.
Exemples
Pour présenter les choix Y, N et C, tapez la ligne suivante dans un fichier de commandes :
choice /c ync
L’invite suivante s’affiche quand le fichier de commandes exécute la commande choice :
[Y,N,C]?
Pour masquer les choix Y, N et C, mais afficher le texte Yes, No ou Continue, 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 que vous n’utilisez pas /m, l’utilisateur ne reçoit pas d’invite quand choice attend une entrée.
Pour afficher le texte et les options utilisés 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 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 un délai de cinq secondes, choice sélectionne N par défaut et renvoie la valeur d’erreur 2. Sinon, choice renvoie la valeur correspondant au choix de l’utilisateur.