Objet :Afficher une boîte de dialogue de tâches Windows

 

Format :TASKDIALOG [/A[F][X]"Details" /AC"text" /AE"text" /B"text" /C /DB:n /DR:n /E /F[EISW]"text" /H /I /L /N /P=x,y /R"text" /S /T:n /V"text" /W /X] buttontype "title" "instruction" [text]

 

buttontypeUn ou plusieurs boutons parmi OK, YES, NO, RETRY, CANCEL et/ou CLOSE
titleTexte du titre de la boîte de dialogue de la tâche
instructionTexte de l'instruction principale
textTexte supplémentaire facultatif qui apparaît sous l'instruction principale, dans une police plus petite

 

/A (détails) /L(encres)
/B(texte de l'énoncé) /N(liens)
/C(boîte à outils) /P(osition)
/DB (bouton par défaut) /R(boutons radio)
/DR (bouton radio par défaut) /S(icône du haut)
/E (bouclier) /T(imeout)
/F(ooter) /V(erification)
/H(yperlinks) /W(arning icon )
/I(icône d'information) /X(fermable)

 

Voir aussi : INKEY, INPUT, MSGBOX et QUERYBOX.

 

Utilisation :

 

Lebouton choisi par l'utilisateur est indiqué à l'aide de la variable interne %_ ? Veillez à sauvegarder la valeur de retour dans une autre variable ou à la tester immédiatement, car la valeur de %_ ? change à chaque commande interne. La liste suivante indique la valeur renvoyée pour chaque bouton :

 

réponse

%_ ?

Yes or OK

10

No

11

Cancel or Close

12

Retry

13

 

En cas d'erreur dans la commande TASKDIALOG elle-même, %_ ? prendra la valeur 2.

 

Comme TASKDIALOG n'écrit pas sur la sortie standard, il désactive la redirection, ce qui vous permet de saisir les caractères de redirection (< et >) dans votre texte d'invite. Si vous souhaitez utiliser des caractères de pipe ou des séparateurs de commandes, vous devrez les échapper ou les mettre entre guillemets.

 

TASKDIALOG crée une boîte de dialogue contextuelle. Si vous préférez récupérer les données de la ligne de commande, consultez les  commandes INKEY et INPUT.

 

Vous pouvez copier le texte d'une fenêtre de TASKDIALOG dans le presse-papiers en appuyant sur Ctrl-C lorsque la fenêtre de TASKDIALOG est au premier plan.

 

Le TASKDIALOG peut définir trois variables internes :

 

_taskdialog_button - le bouton pressé pour quitter TASKDIALOG

_taskdialog_radio - le bouton radio sélectionné (le cas échéant) dans TASKDIALOG

_taskdialog_verify - renvoie 1 si le bouton de vérification a été coché

 

Exemple :

 

Afficher une boîte de message Oui/Non et prendre des mesures en fonction du résultat :

 

taskdialog yes no "Copy" "Copy all files to A:?"

if %_? == 10 copy * a:

 

Options :

 

/A "details" TASKDIALOGaffiche un bouton sur lequel vous pouvez cliquer pour développer la boîte de dialogue et afficher le texte spécifié dans "Details".

 

/AC"text"Le texte du bouton pour réduire les informations extensibles.

 

/AE"text"Le texte du bouton permettant de développer les informations extensibles.

 

/AF "details"Comme /A, mais TASKDIALOG affichera les détails au bas de la zone de pied de page de la boîte de dialogue au lieu de les afficher immédiatement après le contenu.

 

/AX "details"Comme /A, mais TASKDIALOG affichera les détails développés par défaut.

 

/B "text"Texte à utiliser pour les boutons personnalisés. Si vous spécifiez un ou plusieurs arguments /B, TASKDIALOG n'affichera aucun des boutons par défaut. TASKDIALOG renvoie l'identifiant du bouton enfoncé dans la variable de commande %_taskdialog_button. TASKDIALOG numérote les boutons personnalisés en commençant par 1000. Le nombre maximum de boutons personnalisés est de 10.

 

/CCochez la case de vérification au démarrage de TASKDIALOG. (Par défaut, la case n'est pas cochée.)

 

/DB:xxBouton par défaut. Il peut s'agir d'un nombre (1000-n pour les boutons personnalisés) ou d'un type de bouton défini :

 

OK

Oui

Non

Annuler

Réessayer

Fermer

 

/DR:nLa case d'option par défaut (2000 - n, valable uniquement lorsqu'elle est utilisée avec /R).

 

/EAfficher l'icône du bouclier de sécurité de Windows.

 

/F "text" Affiche le texte du pied de page avec une icône optionnelle :

 

Ebouclier de sécurité
Iinformation
Serreur
Wavertissement

 

/H Activer les hyperliens intégrés dans le texte des informations complémentaires (/A), le texte du pied de page (/F) et le texte de l'instruction principale. Les hyperliens sont créés à l'aide d'un onglet HTML <a>. Par exemple :

 

/A "Ceci est un hyperlien : <a href=^"https://jpsoft.com/^">Tous les détails sur Take Command 28</a>"

 

/IAfficher une icône composée d'un "i" minuscule dans un cercle dans la boîte de message.

 

/LConvertir les boutons définis par /B en liens de commande. Un lien de commande est un bouton plus grand qui comporte une icône et éventuellement une deuxième ligne de texte plus petite. (Pour afficher une deuxième ligne, ajoutez un ^n à l'argument /B, suivi du texte de la deuxième ligne).

 

/NLes boutons personnalisés (voir /B et /R) doivent être affichés comme des liens de commande au lieu de boutons-poussoirs ou de boutons radio.

 

/PAffiche la boîte de dialogue de la tâche aux coordonnées d'écran spécifiées. Si /P n'est pas spécifié, TCC centre la boîte de dialogue.

 

/R "text"Affiche les boutons radio. Le bouton sélectionné sera renvoyé dans la variable de commande %_taskdialog_radio. TASKDIALOG numérote les ID des boutons radio personnalisés en commençant par 2000. Le nombre maximum de boutons radio est de 10.

 

/SAfficher une icône de panneau d'arrêt dans la boîte à messages.

 

/T:nDélai d'attente après n secondes. Si TASKDIALOG se termine, il renvoie la valeur du bouton Annuler / Fermer (12).

 

/V "text"Affiche une case à cocher de vérification. Si la case est cochée, la variable de commande %_taskdialog_verify sera définie lorsque TASKDIALOG se terminera.

 

/WAfficher une icône de point d'exclamation dans la boîte de message.

 

/XLa boîte de dialogue des tâches peut être fermée à l'aide des touches Alt-F4, Escape et du bouton de fermeture de la barre de titre, même si aucun bouton d'annulation n'est spécifié.