dialog |
Dialogue |
|---|---|
| Linux | Externe |
Syntaxe
| dialog options { --and-widget options } |
où les options sont des options «communes», suivies des options de «boîtes» :
| [--create-rc "file"] | Les options spéciales |
|
[--ascii-lines] [--aspect ratio] [--backtitle backtitle] [--begin y x] [--cancel-label str] [--clear] [--colors] [--column-separator str] [--cr-wrap] [--default-item str] [--defaultno] [--exit-label str] [--extra-button] [--extra-label str] [--help-button] [--help-label str] [--help-status] [--ignore] [--input-fd fd] [--insecure] [--item-help] [--keep-tite] [--keep-window] [--max-input n] [--no-cancel] [--no-collapse] [--no-kill] [--no-label str] [--no-lines] [--no-ok] [--no-shadow] [--nook] [--ok-label str] [--output-fd fd] [--output-separator str] [--print-maxsize] [--print-size] [--print-version] [--quoted] [--separate-output] [--separate-widget str] [--shadow] [--single-quoted] [--size-err] [--sleep secs] [--stderr] [--stdout] [--tab-correct] [--tab-len n] [--timeout secs] [--title title] [--trace file] [--trim] [--version] [--visit-items] [--yes-label str] |
Les options communes |
|
--calendar text height width day month year --checklist text height width list-height tag1 item1 status1... --dselect directory height width --editbox file height width --form text height width form-height label1 l_y1 l_x1 item1 i_y1 i_x1 flen1 ilen1... --fselect filepath height width --gauge text height width [percent] --infobox text height width --inputbox text height width [init] --inputmenu text height width menu-height tag1 item1... --menu text height width menu-height tag1 item1... --mixedform text height width form-height label1 l_y1 l_x1 item1 i_y1 i_x1 flen1 ilen1 itype... --mixedgauge text height width percent tag1 item1... --msgbox text height width --passwordbox text height width [init] --passwordform text height width form-height label1 l_y1 l_x1 item1 i_y1 i_x1 flen1 ilen1... --pause text height width seconds --progressbox height width --radiolist text height width list-height tag1 item1 status1... --tailbox file height width --tailboxbg file height width --textbox file height width --timebox text height width hour minute second --yesno text height width |
Les options de boites (Box) |
Paramètres
Voici les options communs :
| Nom | Description |
|---|---|
| --ascii-lines | Ce paramètre permet d'indiquer que plutôt que de dessiner des lignes graphiques autour des cases, dessinez ASCII "+" et "-" à ces endroits. Voir aussi "--no-lines". |
| --aspect ratio | Ce paramètre permet de contrôler les dimensions de la boîte lorsque vous utilisez le dimensionnement automatique (en spécifiant 0 pour la hauteur et la largeur). Il représente la largeur/hauteur. La valeur par défaut est 9, ce qui signifie 9 caractères de largeur à chaque hauteur d'une ligne. |
| --backtitle backtitle | Ce paramètre permet d'indiquer une chaîne de caractères de sous-titres à afficher sur le fond, en haut de l'écran. |
| --begin y x | Ce paramètre permet d'indiquer la position du coin supérieur gauche d'une boîte de dialogue à l'écran. |
| --cancel-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons «Cancel». |
| --clear | Ce paramètre permet d'effacer l'écran du widget en ne conservant que l'arrière-plan screen_color. Utilisez ce paramètre lorsque vous combinez les widgets avec "--and-widget" pour effacer le contenu d'un widget précédent à l'écran, afin qu'il ne soit pas visible sous le contenu d'un widget suivant. |
| --colors | Ce paramètre permet d'interpréter les séquences "\Z" incorporées dans le texte de la boîte de dialogue à l'aide du caractère suivant, indiquant à la boîte de dialogue de définir les couleurs ou les attributs vidéo: blanc respectivement. Le gras est défini par «b», réinitialisé par «B». L'inverse est défini par 'r', réinitialisé par 'R'. Le soulignement est défini par "u", réinitialisé par "U". Les paramètres sont cumulatifs, par exemple, "\Zb\Z1" rend le texte suivant en rouge (peut-être très lumineux). Restaurez les paramètres normaux avec "\Zn". |
| --column-separator string | Ce paramètre permet d'indiquer à la boîte de dialogue de fractionner les données pour les cases à cocher/bouton radio et les menus sur les occurrences de la chaîne de caractères spécifiée, et d'aligner les données fractionnées en colonnes. |
| --cr-wrap | Ce paramètre permet d'interpréter les nouvelles lignes incorporées dans le texte de la boîte de dialogue en tant que nouvelles lignes à l'écran. Sinon, la boîte de dialogue ne renfermera que des lignes si nécessaire pour tenir dans la zone de texte. Même si vous pouvez contrôler les sauts de ligne avec ce paramètre, la boîte de dialogue enveloppera les lignes trop longues pour la largeur de la zone. Sans le paramètre «--cr-wrap», la mise en page de votre texte risque d'être mise en forme dans le code source de votre script sans affecter la présentation dans la boîte de dialogue. Voir aussi les paramètres "--no-collapse" et "--trim". |
| --create-rc file | Ce paramètre permet d'indiquer que lorsque la boîte de dialogue prend en charge la configuration au moment de l'exécution, elle peut être utilisée pour transférer un exemple de fichier de configuration dans le fichier spécifié. |
| --defaultno | Ce paramètre permet de définir la valeur par défaut de la zone «yes/no» sur «No». De même, vous pouvez définir le bouton par défaut des widgets fournissant "OK" et "Cancel" à «Cancel». Si "--nocancel" ou "--visit-items" reçoit des paramètres, ce paramètre est prioritaire, le bouton par défaut est toujours "Yes" (identique à "OK" en interne). |
| --default-item string | Ce paramètre permet de définir l'élément par défaut dans une liste de contrôle, un formulaire ou une zone de menu. Normalement, le premier élément de la boîte de dialogue est la valeur par défaut. |
| --exit-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons «EXIT». |
| --extra-button | Ce paramètre permet d'afficher un bouton supplémentaire, entre les boutons "OK" et "Cancel". |
| --extra-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons "Extra". Remarque: pour les widgets «inputmenu», la valeur par défaut est «Rename». |
| --help | Ce paramètre permet d'afficher le message d'aide sur cette commande. |
| --help-button | Ce paramètre permet d'afficher un bouton d'aide après les boutons "OK" et "Cancel", c'est-à-dire dans les listes de contrôle, les listes des boutons radio et les menus. Si le paramètre "--item-help" est également indiqué, à la sortie, l'état de retour sera identique à celui du bouton "OK" et le texte d'aide aux éléments sera écrit dans la sortie du dialogue après le jeton "HELP". Sinon, l'état de retour indiquera que le bouton HELP a été appuyé et qu'aucun message n'a été affiché. |
| --help-label string | Ce paramètre permet d'indiquer de remplacer l'étiquette utilisée pour les boutons "HELP". |
| --help-status | Ce paramètre permet d'indiquer que si le bouton d'aide est sélectionné, écrit les informations de la liste de contrôle, de la liste de bouton radio ou du formulaire après les informations "HELP" de l'aide. Il peut être utilisé pour reconstruire l'état d'une liste de contrôle après le traitement de la demande d'aide. |
| --ignore | Ce paramètre permet d'indiquer qu'il faut ignorer les paramètres que la boîte de dialogue ne reconnaît pas. Certains, bien connus, tels que "--icon" sont de toute façon ignorés, mais il s'agit d'un meilleur choix de compatibilité avec d'autres intégrations. |
| --input-fd fd | Ce paramètre permet de lire les entrées au clavier à partir du descripteur de fichier spécifié. La plupart des scripts de dialogue lisent à partir de l'entrée standard, mais le widget gauge lit un tuyau (étant toujours une entrée standard). Certaines configurations ne fonctionnent pas correctement lorsque la boîte de dialogue tente de rouvrir le terminal. Utilisez ce paramètre (avec le jonglage approprié de descripteurs de fichier) si votre script doit fonctionner dans ce type d'environnement. |
| --insecure | Ce paramètre permet de rendre le widget de mot de passe plus convivial mais moins sécurisé, en renvoyant des astérisques pour chaque caractère. |
| --item-help | Ce paramètre permet d'interpréter les données de balises pour les listes de contrôle, les listes de bouton radio et les menus en ajoutant une colonne affichée dans la ligne inférieure de l'écran pour l'élément actuellement sélectionné. |
| --keep-tite | Ce paramètre permet de supprimer les chaînes de caractères d'initialisation le faisant basculer vers l'écran de remplacement s'il est exécuté dans un xterm. |
| --keep-window | Ce paramètre permet de supprimer l'ancien widget de l'écran en le repeignant. |
| --max-input size | Ce paramètre permet de limiter les chaînes d'entrée à la taille donnée. Si non spécifié, la limite est 2048. |
| --no-cancel | Ce paramètre permet de supprimer le bouton «Cancel» dans les modes liste de contrôle, zone de saisie et menu. Un script peut toujours tester si l'utilisateur a appuyé sur la touche ESC pour annuler pour quitter. |
| --nocancel | Ce paramètre permet de supprimer le bouton «Cancel» dans les modes liste de contrôle, zone de saisie et menu. Un script peut toujours tester si l'utilisateur a appuyé sur la touche ESC pour annuler pour quitter. |
| --no-collapse | Ce paramètre permet de convertir les tabulations de la boite de dialogue en espaces et réduit plusieurs espaces en un seul espace pour le texte affiché dans les boîtes de message,... Utilisez ce paramètre pour désactiver cette fonctionnalité. Notez que la boîte de dialogue continuera à envelopper le texte, sous réserve des paramètres --cr-wrap et --trim. |
| --no-kill | Ce paramètre permet d'indiquer à la boîte de dialogue de placer la boîte tailboxbg à l'arrière-plan, en affichant son identificateur de processus sur la sortie de la boîte de dialogue. SIGHUP est désactivé pour le processus en arrière-plan. |
| --no-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons «No». |
| --no-lines | Ce paramètre permet de tracer des espaces au même endroit plutôt que de tracer des lignes autour des cases. |
| --no-ok | Ce paramètre permet de supprimer le bouton «OK» dans les modes liste de contrôle, zone de saisie et de menu. Un script peut toujours tester si l'utilisateur a appuyé sur la touche Enter pour accepter les données. |
| --no-shadow | Ce paramètre permet de supprimer les ombres étant dessinées à droite et en bas de chaque boîte de dialogue. |
| --ok-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons "OK". |
| --output-fd fd | Ce paramètre permet de sortie directe vers le descripteur de fichier spécifié. La plupart des scripts de dialogue écrivent dans la sortie standard d'erreur, mais des messages d'erreur peuvent également y être écrits, en fonction de votre script. |
| --output-separator string | Ce paramètre permet de sortie directe vers le descripteur de fichier spécifié. La plupart des scripts de dialogue écrivent dans la sortie standard d'erreur, mais des messages d'erreur peuvent également y être écrits, en fonction de votre script. |
| --print-maxsize | Ce paramètre permet d'afficher la taille maximale des boîtes de dialogue, c'est-à-dire la taille de l'écran, dans la sortie de la boîte de dialogue. Il peut être utilisé seul, sans autres paramètres. |
| --print-size | Ce paramètre permet d'afficher la taille de chaque boîte de dialogue dans la sortie de la boîte de dialogue. |
| --print-version | Ce paramètre permet d'afficher la version de la commande dialog dans la sortie du dialogue. Il peut être utilisé seul, sans autres paramètres. |
| --separate-output | Ce paramètre permet d'afficher le résultat ligne par ligne, sans citation, pour les widgets de liste de contrôle. Facilitant l'analyse par un autre programme. |
| --separate-widget string | Ce paramètre permet d'indiquer une chaîne de caractères séparant la sortie de la boîte de dialogue de chaque widget. Ceci est utilisé pour simplifier l'analyse du résultat d'un dialogue avec plusieurs widgets. Si ce paramètre n'est pas spécifiée, la chaîne de caractères de séparation par défaut est un caractère de tabulation. |
| --separator string | Ce paramètre permet de spécifier une chaîne de caractères séparant la sortie de la boîte de dialogue de la liste de contrôle plutôt que la nouvelle ligne (pour --separate-output) ou un espace. Ceci s'applique à d'autres widgets tels que les formulaires et les boîtes de saisie utilisant normalement une nouvelle ligne. |
| --shadow | Ce paramètre permet de dessiner une ombre à droite et en bas de chaque boîte de dialogue. |
| --single-quoted | Ce paramètre permet d'utiliser des guillemets simples si nécessaire (et pas de guillemets si cela n'est pas nécessaire) pour la sortie de la liste de contrôle ainsi que pour le texte d'aide. Si ce paramètre n'est pas définie, la boîte de dialogue utilise des guillemets autour de chaque élément. Il nécessite l'utilisation occasionnelle de barres obliques inverses pour rendre la sortie utile dans les scripts d'interpréteur de commandes. |
| --size-err | Ce paramètre permet de vérifier la taille résultante d'une boîte de dialogue avant d'essayer de l'utiliser, en affichant la taille résultante si elle est plus grande que l'écran. Ce paramètre est obsolète, car tous les appels de nouvelle fenêtre sont vérifiés. |
| --sleep secs | Ce paramètre permet d'indiquer le délai pendant le nombre de secondes indiqué après le traitement d'une boîte de dialogue. |
| --stderr | Ce paramètre permet d'indiquer que la sortie directe va vers la sortie standard d'erreur. C'est la valeur par défaut, car curses écrit normalement les mises à jour d'écran sur la sortie standard. |
| --stdout | Ce paramètre permet d'indiquer que la sortie directe va vers la sortie standard. Ce paramètre est fournie pour la compatibilité avec Xdialog. Cependant, son utilisation dans des scripts portables n'est pas recommandée, car curses écrit normalement ses mises à jour d'écran sur la sortie standard. Si vous utilisez ce paramètre, la boîte de dialogue tente de rouvrir le terminal afin qu'il puisse écrire sur l'affichage. Selon la plate-forme et votre environnement, il peut échouer. |
| --tab-correct | Ce paramètre permet de convertir chaque caractère de tabulation en un ou plusieurs espaces (pour le widget zone de texte; sinon, en un seul espace). Sinon, les onglets sont rendus en fonction de l'interprétation de la bibliothèque curses. |
| --tab-len n | Ce paramètre permet d'indiquer le nombre d'espaces qu'un caractère de tabulation occupe si le paramètre --tab-correct est spécifiée. La valeur par défaut est 8. Ce paramètre est effective uniquement pour le widget de zone de texte. |
| --timeout secs | Ce paramètre permet d'indiquer le temps de dépassement de délai (exit avec code d'erreur) si aucune réponse de l'utilisateur n'est reçue dans le nombre de secondes spécifié. Il est annulé si l'arrière-plan --tailboxbg est utilisé. Une temporisation de 0 seconde est ignorée. |
| --title title | Ce paramètre permet d'indiquer une chaîne de caractères de titre à afficher en haut de la boîte de dialogue. |
| --trace filename | Ce paramètre permet d'enregistrer les frappes au fichier spécifié. Utilisez Ctrl+T pour enregistrer une image de la fenêtre de dialogue en cours. |
| --trim | Ce paramètre permet d'éliminer les espaces en début de ligne, supprime les nouvelles lignes littérales et les espaces répétés du texte du message. |
| --version | Ce paramètre permet d'afficher la version de la commande dialog dans la sortie du dialogue. Il peut être utilisé seul, sans autres paramètres. |
| --visit-items | Ce paramètre permet de modifier le parcours de tabulation de la liste de contrôle, de la boite de bouton radio, de la boite de menu et des entrées de menu pour inclure la liste des éléments dans l'un des états. Ce paramètre est utile comme aide visuelle, c'est-à-dire que la position du curseur aide certains utilisateurs. Lorsque ce paramètre est spécifiée, le curseur est initialement placé sur la liste. Les abréviations (la première lettre de la balise) s'appliquent aux éléments de la liste. Si vous passez à la rangée de boutons, les abréviations s'appliquent aux boutons. |
| --yes-label string | Ce paramètre permet de remplacer l'étiquette utilisée pour les boutons «Yes». |
Voici les options de boite :
| Nom | Description |
|---|---|
| height | Ce paramètre permet d'indiquer la hauteur de la boite de dialogue. |
| width | Ce paramètre permet d'indiquer la largeur de la boite de dialogue. |
| --calendar text height width day month year | Ce paramètre permet d'indiquer un calendrier affichant le mois, le jour et l'année dans des fenêtres réglables séparément. Si les valeurs de jour, mois ou année sont manquantes ou négatives, les valeurs correspondantes de la date du jour sont utilisées. Vous pouvez incrémenter ou décrémenter n'importe lequel de ceux-ci en utilisant les flèches vers la gauche, vers le haut, vers la droite et vers le bas. |
| --checklist text height width list-height [ tag item status ] ... | Ce paramètre permet d'indiquer une liste de contrôle. En sortie, une liste des chaînes de caractères de balises des entrées activées sera affichée sur la sortie de la boîte de dialogue. |
| --dselect filepath height width | Ce paramètre permet d'afficher la boîte de dialogue de sélection de répertoires en une fenêtre de saisie de texte dans laquelle vous pouvez taper un répertoire et, au-dessus, une fenêtre avec des noms de répertoires. |
| --editbox filepath height width | Ce paramètre permet d'afficher la boîte de dialogue d'édition en une copie du fichier. Vous pouvez le modifier en utilisant les touches BackSpace, Delete et les touches de curseur pour corriger les erreurs de frappe. |
| --fselect filepath height width | Ce paramètre permet d'afficher la boîte de dialogue de sélection de fichier en une fenêtre de saisie de texte dans laquelle vous pouvez saisir un nom de fichier (ou un répertoire), et au-dessus deux fenêtres avec des noms de répertoire et des noms de fichiers. Ici le chemin de fichier peut être un chemin de fichier, auquel cas la fenêtre de fichier et de répertoire affichera le contenu du chemin et la fenêtre de saisie de texte contiendra le nom de fichier présélectionné. |
| --gauge text height width [percent] | Ce paramètre permet d'afficher une boîte de jauge en un mètre au bas de la boîte. Le compteur indique le pourcentage. Les nouveaux pourcentages sont lus à partir de l'entrée standard, un entier par ligne. Le compteur est mis à jour pour refléter chaque nouveau pourcentage. |
| --infobox text height width | Ce paramètre permet d'afficher une boîte d'informations. Une boîte d'informations est essentiellement une boîte de message. Cependant, dans ce cas, la boîte de dialogue se fermera immédiatement après l'affichage du message destiné à l'utilisateur. L'écran n'est pas effacé lorsque la boîte de dialogue se ferme, de sorte que le message reste à l'écran jusqu'à ce que le script de l'interpréteur de commande appelant l'efface ultérieurement. |
| --inputbox text height width [init] | Ce paramètre permet d'afficher une boîte de saisie d'entrée. Une boite de saisie d'entrée est utile lorsque vous souhaitez poser des questions demandant à l'utilisateur de saisir une chaîne de caractères comme réponse. |
| --inputmenu text height width menu-height [ tag item ] ... | Ce paramètre permet d'afficher une boîte de menu d'entrée. |
| --menu text height width menu-height [ tag item ] ... | Ce paramètre permet d'afficher un menu. Comme son nom l'indique, une boîte de menu est une boîte de dialogue pouvant être utilisée pour présenter une liste de choix sous la forme d'un menu que l'utilisateur peut choisir. |
| --mixedgauge text height width percent [ tag1 item1 ] ... | Ce paramètre permet d'afficher une boîte de jauge mixte affichant un mètre au bas de la boîte. |
| --msgbox text height width | Ce paramètre permet d'afficher une boîte de message avec un bouton «OK». |
| --pause text height width seconds | Ce paramètre permet d'afficher une boîte de pause affichant un mètre au bas de la boîte. |
| --passwordbox text height width [init] | Ce paramètre permet d'afficher une boîte de mot de passe dans lequel le texte saisi par l'utilisateur n'est pas affiché. |
| --progressbox text height width --progressbox height width |
Ce paramètre permet d'afficher une boîte de progression, allant se fermer lorsqu'elle atteindra la fin du fichier. |
| --radiolist text height width list-height [ tag item status ] ... | Ce paramètre permet d'afficher une liste de bouton radio. |
| --tailbox file height width | Ce paramètre permet d'afficher le texte d'un fichier dans une boîte de dialogue, comme dans une commande «tail -f». |
| --tailboxbg file height width | Ce paramètre permet d'afficher le texte d'un fichier dans une boîte de dialogue en tant que tâche en arrière-plan, comme dans une commande «tail -f». |
| --textbox file height width | Ce paramètre permet d'afficher le contenu d'un fichier texte dans une boîte de dialogue. |
| --timebox text height [width hour minute second] | Ce paramètre permet d'afficher une boîte de dialogue sélectionnant l'heure, les minutes et les secondes. |
| --yesno text height width | Ce paramètre permet d'afficher une boîte de dialogue avec les boutons «YES» et «NO». |
Description
Cette commande permet d'afficher des boites de dialogues dans un script d'interpréteur de commande.
Installation
On peut installer cette commande sous Amazon AMI Linux à l'aide de la commande suivante :
| sudo yum install dialog |
Dernière mise à jour : Mercredi, le 20 mai 2019