Objet :Affiche une boîte de dialogue pour obtenir une chaîne de caractères de l'utilisateur et l'enregistrer dans une variable d'environnement.

 

Format :QUERYBOX [/= /CUE="text" /D /E /Ln /P /POS=top,left /Tn] ["title"] prompt %%varname

 

titleTexte pour la barre de titre de la boîte de dialogue.
promptTexte qui apparaîtra à l'intérieur de la boîte de dialogue.
varnameNom de la variable dans laquelle les données seront enregistrées.
/CUETexte de repère àafficher dans la boîte de saisie

 

/D(igits only)

/P(mot de passe)

/E(dit valeur existante)

/POS (position)

/L (longueur maximale)

/T(imeout)

 

Voir aussi : INKEY, INPUT et MSGBOX.

 

Utilisation :

 

QUERYBOX affiche une boîte de dialogue avec une invite, un titre facultatif et un champ de saisie de chaîne de caractères. Elle attend ensuite votre entrée et place les caractères que vous tapez dans une variable d'environnement. QUERYBOX est normalement utilisé dans les fichiers batch et les alias pour obtenir une entrée de texte.

 

QUERYBOX est similaire à INPUT, sauf qu'il apparaît sous la forme d'une boîte de dialogue contextuelle. Si vous préférez travailler dans la fenêtre de la ligne de commande, consultez les commandes INKEY et INPUT.

 

L'option /CUE affiche le texte du repère en gris clair dans la boîte de saisie (il disparaît dès que vous entrez un caractère).

 

Les touches d'édition standard de la ligne de commande peuvent être utilisées pour modifier la chaîne de caractères au fur et à mesure qu'elle est saisie. Tous les caractères entrés jusqu'au retour chariot inclus sont stockés dans la variable.

 

Si vous appuyez sur Ctrl-C ou Ctrl-Break pendant que QUERYBOX attend une entrée, l'exécution d'un alias sera interrompue, et l'exécution d'un fichier batch sera suspendue pendant que l'on vous demandera si vous voulez annuler le travail batch. Un fichier batch peut gérer Ctrl-C et Ctrl-Break lui-même avec ON BREAK.

 

QUERYBOX renvoie une valeur de zéro dans la variable interne %_ ? après une opération réussie, et une valeur non nulle dans le cas contraire (un délai d'attente renvoie 20, une annulation renvoie 2). Veillez à sauvegarder la valeur de retour dans une autre variable ou à la tester immédiatement, car la valeur de %_ ? change à chaque commande interne.

 

Si vous n'entrez aucun argument, QUERYBOX affichera son dialogue de commande.

 

Exemple : pour demander une chaîne de caractères et l'enregistrer dans une autre variable :

 

Pour demander une chaîne de caractères et la stocker dans la variable NOM :

 

querybox "File Name" Entrez un nom : %%name

 

Options :        

 

/=Affiche le dialogue de commande de QUERYBOX pour vous aider à définir les options de la ligne de commande. L'option /= peut être placée n'importe où sur la ligne ; les options supplémentaires définiront les champs appropriés dans la boîte de dialogue de commande.

 

/DN'accepte que les valeurs numériques.

 

/EPermet de modifier une valeur existante. S'il n'y a pas de valeur existante pour varname, QUERYBOX vous permet d'entrer une nouvelle valeur.

 

/Ln Fixeà n le nombre maximum de caractères acceptés par QUERYBOX .

 

/PIndique à QUERYBOX d'afficher des astérisques à la place des caractères que vous tapez.

 

/POS Définitla position du dialogue. (Si vous ne spécifiez pas de position, QUERYBOX centrera le dialogue dans la fenêtre. TCC fenêtre.

 

/TnAttendre une réponse pendant unmaximum den secondes.