Objectif :Affiche une boîte de dialogue pour obtenir une chaîne d'entrée de l'utilisateur et l'enregistrer dans une variable d'environnement

 

Format:QUERYBOX [/= /CUE="texte" /D /E /Ln /P /POS=en haut à gauche /Tn] ["titre"] invite %%varname

 

titreTexte de la barre de titre de la boîte de dialogue.
rapideTexte qui apparaîtra dans la boîte de dialogue.
varnameNom de la variable où l'entrée sera enregistrée.
/SIGNALTexte de repère à afficher dans la zone de saisie

 

/D(igits uniquement)

/Mot de passe)

/E(modifier la valeur existante)

/Position)

/L (longueur maximale)

/Temps mort)

 

Voir aussi: CLÉ D'ENTRÉE, CONTRIBUTIONet MSGBOX.

 

Usage:

 

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

 

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

 

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

 

Les touches d'édition de ligne de commande standard peuvent être utilisées pour modifier la chaîne d'entrée au fur et à mesure de sa saisie. Tous les caractères saisis jusqu'au retour chariot, mais non compris, sont stockés dans la variable.

 

Si vous appuyez sur Ctrl-C or Ctrl-Pause pendant que QUERYBOX attend une entrée, l'exécution d'un alias sera terminée et l'exécution d'un fichier batch sera suspendue pendant qu'il vous sera demandé si vous devez annuler le travail par lots. Un fichier batch peut gérer Ctrl-C et Ctrl-Pause lui-même avec EN PAUSE.

 

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 timeout renvoie 20, une annulation renvoie 2). Assurez-vous de sauvegarder la valeur de retour dans une autre variable ou de la tester immédiatement ; parce que la valeur de %_ ? change à chaque commande interne.

 

Si vous n'entrez aucun argument, QUERYBOX affichera sa boîte de dialogue de commande.

 

Mise en situation :

 

Pour demander une chaîne et la stocker dans la variable NAME :

 

querybox "Nom du fichier" Saisissez un nom : %%name

 

options:        

 

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

 

/DN'accepte que les valeurs numériques.

 

/EVous permet de modifier une valeur existante. S'il n'existe aucune valeur existante pour varname, QUERYBOX vous permet de saisir une nouvelle valeur.

 

/Ln Définit le nombre maximum de caractères que QUERYBOX acceptera pour n.

 

/PIndique à QUERYBOX de faire écho aux astérisques au lieu des caractères que vous tapez.

 

/POSDéfinit la position du dialogue. (Si vous ne spécifiez pas de position, QUERYBOX centrera la boîte de dialogue dans le TCC fenêtre.

 

/ TnAttendez au maximum n secondes pour une réponse.