Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] dialog - affiche des boîtes de dialogue depuis des scripts shell [size=18] [b]Résumé[/b] [/size] [b]dialog[/b] --clear [b][/b] [b][i]dialog --create-rc fichier[/i][/b] [b][/b] [b]dialog[/b] --print-maxsize [b][/b] [b]dialog[/b] [i]options-communes[/i] [i]options-boîtes[/i] [size=18] [b]Description[/b] [/size] [b]Dialog[/b] est un programme qui permet de présenter une grande variété de questions ou d'afficher des messages en utilisant des boîtes de dialogue depuis un script shell. Ces types particuliers de dialogues sont inclus (bien que tous ne soient pas nécessairement compilés dans [b]dialog[/b]) :[table][row][col]    [/col][col]     [b]calendar , [/b] [b]checklist , [/b] [b]form , [/b] [b]fselect , [/b] [b]gauge , [/b] [b]infobox , [/b] [b]inputbox , [/b] [b]inputmenu , [/b] [b]menu , [/b] [b]msgbox (message), [/b] [b]password , [/b] [b]radiolist , [/b] [b]tailbox , [/b] [b]tailboxbg , [/b] [b]textbox , [/b] [b]timebox , and [/b] [b]yesno (yes/no).[/b][/col][/row][/table] Vous pouvez mettre plusieurs dialogues dans un script : [table][row][col]    [/col][col]- Utilisez l'indicateur [b][/b]--and-widget pour forcer Dialog à traiter le dialogue suivant tant que vous n'avez pas appuyé sur ESC pour annuler, ou[/col][/row][/table] [table][row][col]    [/col][col]- Ajoutez simplement les indicateurs pour le dialogue suivant de manière à faire une chaîne. Dialog arrête l'enchaînement quand le code retour d'un dialogue est différent de zéro, Cancel (annuler) ou No (non) par exemple. .[/col][/row][/table] [size=18] [b]Options[/b] [/size] Toutes les options commencent par « [b][/b]-- ». Un « [b][/b]-- » par lui-même est utilisé comme un échappement, par exemple, l'élément suivant sur la ligne de commande n'est pas traité comme une option. . [b]fboptions communesfp[/b] . "[b][/b]--aspect [i]ratio"[/i] [table][row][col]    [/col][col]Vous permet de contrôler les dimensions de la boîte en utilisant le dimensionnement automatique (specifiez 0 pour la largeur et la hauteur). Représente la largeur / la hauteur. La valeur par défaut est 9, qui indique 9 caractères de large pour chaque hauteur de ligne. .[/col][/row][/table] "[b][/b]--backtitle [i]titre[/i] de fond" [table][row][col]    [/col][col]Indique une chaîne de caractères comme titre d'arrière-plan, placé en haut de l'écran. .[/col][/row][/table] "[b][/b]--beep [i]bip"[/i] [table][row][col]    [/col][col]Alarme sonore à chaque fois que l'écran est rafraîchi. .[/col][/row][/table] "[b][/b]--beep-after[i]"[/i] [table][row][col]    [/col][col]Un bip si l'entrée est interrompue, par un control/C par exemple. .[/col][/row][/table] "[b][/b]--begin [i]y[/i] x" [table][row][col]    [/col][col]Indique la position du coin supérieur gauche de la boîte de dialogue sur l'écran. .[/col][/row][/table] "[b][/b]--cancel-label [i]chaîne"[/i] [table][row][col]    [/col][col]Modifie le libellé utilisé pour les boutons « Cancel » (en général on utilisera --cancel-label Annuler). .[/col][/row][/table] "[b][/b]--clear[i]"[/i] [table][row][col]    [/col][col]L'écran sera effacé à la sortie avec l'attribut [b]screen[/b] attribute. Ceci ne devrait être utilisé que seul, sans autre option. .[/col][/row][/table] "[b][/b]--colors[i]"[/i] [table][row][col]    [/col][col]Interprète les séquences "" dans le dialogue texte comme caractère permettant de sélectionner les couleurs et attributs vidéo : 0 à 7 sont les codes ANSI utilisés dans curses respectivement : 0=noir, 1=rouge, 2=vert, 3=jaune, 4=bleu, 5=magenta, 6=cyan 7=blanc. Le gras (ou sur brillance) est mis par 'b', son annulation par 'B'. L'inversion est mise par 'r', son annulation par 'R'. Le soulignement est mis par 'u', son annulation par 'U'. Les paramètres sont cumulatifs, ainsi "b1" produira un texte rouge en gras. Le retour à la normale se fait avec "n". .[/col][/row][/table] "[b][/b]--cr-wrap[i]"[/i] [table][row][col]    [/col][col]Interprète les nouvelles lignes d'un texte dans un dialogue comme nouvelles lignes sur l'écran. Sinon, [b]dialog[/b] ne coupera les lignes que lorsque nécessaire pour correspondre à la boîte texte. Vous pouvez contrôler les ruptures de ligne avec cette option, [b]dialog[/b] coupera toute ligne qui serait trop longue pour la taille de la boîte. Sans cr-wrap, l'apparence de votre texte peut être formatée pour un meilleur aspect du code source de votre script sans affecter la manière dont il apparaîtra à l'écran. .[/col][/row][/table] "[b][/b]--create-rc [i]fichier"[/i] [table][row][col]    [/col][col]Lorsque [b]dialog[/b] gère la configuration d'exécution, ceci peut être utilisé pour créer un fichier de configuration exemple indiqué par [b]fichier .[/b] .[/col][/row][/table] "[b][/b]--defaultno [i]"[/i] [table][row][col]    [/col][col]Prépositionne la valeur par défaut d'une boîte [b]yes/no[/b] (oui/non) à [b]no .[/b] .[/col][/row][/table] "[b][/b]--default-item [i]chaîne"[/i] [table][row][col]    [/col][col]Positionne l'élément par défaut dans une boîte de menu. Normalement le premier élément est celui par défaut. .[/col][/row][/table] "[b][/b]--exit-label [i]chaîne"[/i] [table][row][col]    [/col][col]Remplace le libellé utilisé pour les boutons « EXIT ». .[/col][/row][/table] "[b][/b]--extra-button [i]"[/i] [table][row][col]    [/col][col]Affiche un bouton supplémentaire entre les boutons « Ok » et « Cancel ». .[/col][/row][/table] "[b][/b]--extra-label [i]chaîne"[/i] [table][row][col]    [/col][col]Remplace le libellé utilisé pour le bouton « Extra ». Note : pour la fonction inputmenu, la valeur par défaut est « Rename ». .[/col][/row][/table] "[b][/b]--help [i]"[/i] [table][row][col]    [/col][col]Imprime le message d'aide sur la sortie d'erreur standard. Le message d'aide est imprimé si aucune option n'est précisée. .[/col][/row][/table] "[b][/b]--help-button [i]"[/i] [table][row][col]    [/col][col]Montre un bouton d'aide après les boutons « Ok » et « Cancel », par exemple dans un checklist, une radiolist et une boîte menu. Si [b][/b]--item-help est aussi indiqué, à la sortie le code d'état sera le même que pour le bouton « Ok », et le texte de l'élément d'aide sera écrit sur la sortie d'erreur standard après l'indicateur « HELP ». Sinon, le code d'état indique que le bouton d'aide a été appuyé, et aucun message n'est imprimé. .[/col][/row][/table] "[b][/b]--help-label [i]chaîne"[/i] [table][row][col]    [/col][col]Remplace l'étiquette utilisée pour les boutons « help ». .[/col][/row][/table] "[b][/b]--ignore [i]"[/i] [table][row][col]    [/col][col]Ignore les options qui ne sont pas reconnues par [b]dialog[/b]. Certaines, bien connues, comme « [b][/b]--icon » sont systématiquement ignorées, mais il s'agit du meilleur choix de compatibilité avec d'autres implémentations. .[/col][/row][/table] "[b][/b]--item-help [i]"[/i] [table][row][col]    [/col][col]Interprète les données de marquage pour un checklist, un radiolist et une boîte menu en ajoutant une colonne qui est affichée dans la ligne d'en-tête de l'écran, pour l'item sélectionné. .[/col][/row][/table] "[b][/b]--max-input [i]taille"[/i] [table][row][col]    [/col][col]Limite la saisie à une taille donnée. Si non indiqué, la limite est de 2000. .[/col][/row][/table] "[b][/b]--no-cancel [i]"[/col][/row][/table] "[b][/b]--nocancel [i]"[/i] [table][row][col]    [/col][col]Suprime le bouton « Cancel » dans un checklist, un inputbox et une boîte de menu. Un script peut donc tester si l'utilisateur appuie sur la touche ESC pour annuler et quitter. .[/col][/row][/table] "[b][/b]--no-collapse [i]"[/i] [table][row][col]    [/col][col]Normalement [b]dialog[/b] convertit les tabulations en espaces et réduit les espaces multiples en espace simple qui doit être affiché dans une boîte de message, etc. Utilisez cette option pour annuler ce fonctionnement. Notez que [b]dialog[/b] continuera à couper le texte, sujet de l'option [b][/b]--cr-wrap. .[/col][/row][/table] "[b][/b]--no-kill [i]"[/i] [table][row][col]    [/col][col]Indique à [b]dialog[/b] de mettre la boîte [b]tailboxbg[/b] en arrière-plan, imprime son process-id dans la sortie d'erreur standard. SIGHUP est invalidé pour ce process en arrière-plan. .[/col][/row][/table] "[b][/b]--no-shadow [i]"[/i] [table][row][col]    [/col][col]Supprime l'ombrage qui serait dessiné à droite et en bas de chaque boîte de dialogue. .[/col][/row][/table] "[b][/b]--ok-label [i]chaîne"[/i] [table][row][col]    [/col][col]Remplace l'étiquette utilisée pour les boutons « OK ». .[/col][/row][/table] "[b][/b]--output-fd [i]descripteur-de-fichier"[/i] [table][row][col]    [/col][col]Redirige la sortie vers le descripteur de fichier indiqué. Beaucoup de scripts [b]dialog[/b] écrivent dans la sortie d'erreur standard, mais les messages d'erreur peuvent aussi s'y inscrire, cela dépend de votre script. .[/col][/row][/table] "[b][/b]--print-maxsize [i]"[/i] [table][row][col]    [/col][col]Imprime la taille maximum des boîtes de dialogue, par exemple la taille de l'écran, dans la sortie standard d'erreur. Devrait être utilisé seul, sans d'autres options. .[/col][/row][/table] "[b][/b]--print-size [i]"[/i] [table][row][col]    [/col][col]Imprime la taille de chaque boîte de dialogue dans la sortie d'erreur standard. .[/col][/row][/table] "[b][/b]--print-version [i]"[/i] [table][row][col]    [/col][col]Imrime la version de [b]dialog[/b] dans la sortie d'erreur standard. Devrait être utilisé seul, sans d'autres options. .[/col][/row][/table] "[b][/b]--separate-output [i]"[/i] [table][row][col]    [/col][col]Pour un checklist, envoie la sortie une ligne à chaque fois, sans mise entre guillemets. Ceci facilite l'examen par un autre programme. .[/col][/row][/table] "[b][/b]--separator [i]chaîne[/i] [i]"[/col][/row][/table] "[b][/b]--separate-widget [i]chaîne"[/i] [table][row][col]    [/col][col]Indique une chaîne de caractères qui séparera les éléments retournés sur la sortie d'erreur standard pour chaque fonction. Ceci est utilisé pour simplifier l'examen du résultat de dialog avec plusieurs fonctions. Si cette option n'est pas indiquée, le séparateur par défaut est le caractère de tabulation. .[/col][/row][/table] "[b][/b]--shadow [i]"[/i] [table][row][col]    [/col][col]Dessine l'ombrage à droite et en bas de chaque boîte de dialogue. .[/col][/row][/table] "[b][/b]--size-err [i]"[/i] [table][row][col]    [/col][col]Contrôle la taille résultante d'une boîte de dialogue avant d'essayer de l'utiliser, imprime la taille résultante si elle est plus grande que l'écran. (Cette option est obsolète, car tout appel de nouvelle fenêtre est contrôlé). .[/col][/row][/table] "[b][/b]--sleep [i]secs[/i] [i]"[/i] [table][row][col]    [/col][col]Attente (délais) en secondes après exécution de la boîte de dialogue. .[/col][/row][/table] "[b][/b]--stderr [i]"[/i] [table][row][col]    [/col][col]Redirige les éléments retournés vers la sortie d'erreur standard. Ceci est la valeur par défaut, puisque, normalement, curses utilise l'écran pour écrire sur la sortie standard (stdout). .[/col][/row][/table] "[b][/b]--stdout [i]"[/i] [table][row][col]    [/col][col]Redirige les éléments retournés vers la sortie standard. .[/col][/row][/table] "[b][/b]--tab-correct [i]"[/i] [table][row][col]    [/col][col]Convertit chaque caractère de tabulation en un ou plusieurs espaces. Sinon, les tabulations sont rendues selon l'interprétation de la library curses. .[/col][/row][/table] "[b][/b]--tab-len [i]n"[/i] [table][row][col]    [/col][col]Indique le nombre d'espaces occupés par le caractère de tabulation si l'option « [b][/b]--tab-correct » est indiquée. La valeur par défaut est 8. .[/col][/row][/table] "[b][/b]--timeout [i]secs"[/i] [table][row][col]    [/col][col]Expiration du temps (sortie avec un code d'erreur) si aucune réponse de l'utilisateur n'est effectuée dans le nombre indiqué de secondes. .[/col][/row][/table] "[b][/b]--title [i]titre"[/i] [table][row][col]    [/col][col]Spécifie une chaîne de caractères en titre ( [i]title[/i]) à afficher en haut de la boîte de dialogue. .[/col][/row][/table] "[b][/b]--trim [i]"[/i] [table][row][col]    [/col][col]Élimine les espaces de début, les lignes successives et espaces répétés pour un message de texte. .[/col][/row][/table] "[b][/b]--version [i]"[/i] [table][row][col]    [/col][col]Identique à "[b][/b]--print-version". .[/col][/row][/table] [b]Options des boîtes[/b] Toutes les boîtes de dialogue ont au moins trois paramètres : [table][row][col]    [/col][col][i]texte[/i] l'intitulé ou le contenu de la boîte.[/col][/row][/table] [table][row][col]    [/col][col][i]hauteur[/i] la hauteur de la boîte de dialogue.[/col][/row][/table] [table][row][col]    [/col][col][i]largeur[/i] la largeur de la boîte de dialogue.[/col][/row][/table] Les autres paramètres dépendent du type de boîte. "[b][/b]--calendar [i]texte[/i] hauteur largeur jour mois année" [table][row][col]    [/col][col]Une boîte [b]calendar[/b] affiche mois, jour et année dans des zones différentes. Si la valeur du jour, du mois ou de l'année manque ou est négative, la date courante est utilisée. Vous pouvez augmenter ou diminuer l'un ou l'autre en utilisant les flèches de direction. Utilisez, dans le style vi, les touches h, j, k et l pour vous déplacer dans les zones jour dans le mois. Utilisez la tabulation ou son inverse pour vous déplacer entre les différentes zones. Si l'année est zéro, la date courante est utilisée comme valeur initiale. Enfin, la date est restituée sous la forme jour/mois/année. .[/col][/row][/table] "[b][/b]--checklist [i]texte[/i] hauteur largeur hauteur-de-liste [ [i]marqueur1[/i] item1 état] [i]..."[/i] [table][row][col]    [/col][col]Une boîte [b]checklist[/b] est similaire à une boîte [b]menu[/b] ; elle a de multiples entrées présentées sous la forme d'un menu. Au lieu de choisir un élément parmi les différents choix, chaque élément peut être validé ou non par l'utilisateur. L'état initial (on/off) de chaque élément est spécifié par [b]état .[/b] En sortie, une liste des chaînes [i]marqueur[/i] de ces éléments est restituée sur [b]stderr .[/b] .[/col][/row][/table] "[b][/b]--form [i]texte[/i] hauteur largeur hauteur-du-formulaire [ [i]libellé[/i] y x item y x longueur-du-champ longueur-de-l-entrée ] [i]...[/i]" [table][row][col]    [/col][col]Le dialogue form affiche un formulaire constitué de libellés et de champs qui sont positionnés sur une fenêtre déroulante aux coordonnées données par le script. La longueur du champ [i]longueur-du-champ[/i] et la longueur d'entrée [i]longueur-de-l-entrée[/i] indiquent la taille possible du champ. La longueur du champ définit la taille affichée pour un champ sélectionné, tandis que le dernier définit la taille permise pour la donnée entrée dans le champ. Si [i]longueur-du-champ[/i] est zéro, le champ correspondant ne peut être modifié. Si [i]longueur-de-l-entrée[/i] est zéro, il est mis à la valeur de [i]longueur-du-champ[/i]. Utilisez les touches monter/descendre (ou control/N, control/P) pour vous déplacer entre les champs. Utilisez la tabulation pour vous déplacer entre les zones. .[/col][/row][/table] "[b][/b]--fselect [i]chemin-de-fichier[/i] hauteur largeur" [table][row][col]    [/col][col]Le dialogue de sélection de fichier affiche une zone de texte dans laquelle vous pouvez écrire un nom de fichier (ou de répertoire), et au-dessus deux zones pour les répertoires et les noms de fichier. Le [b]chemin-de-fichier[/b] peut être un chemin complet, auquel cas les zones fichiers et répertoires afficheront le contenu du chemin et la zone texte contient le nom du fichier présélectionné. Utilisez la tabulation ou les touches fléchées pour vous déplacer entre les zones. Dans la zone répertoires ou fichiers, utilisez les touches monter/descendre pour dérouler la sélection. Utilisez la barre d'espace pour copier la sélection dans la zone de texte. En tapant un caractère imprimable quelconque, vous serez positionné dans la zone de texte, ce caractère fait défiler la liste des répertoires ou des fichiers de manière à pointer le nom le plus proche. Utilisez la touche retour ou le bouton « OK » pour accepter la valeur actuelle de la zone de texte, ou le bouton « Cancel » pour annuler. [/col][/row][/table] "[b][/b]--gauge [i]texte[/i] hauteur largeur [pourcentage]" [table][row][col]    [/col][col]Une boîte [b]gauge[/b] affiche une barre de progression en bas de la boîte. La barre indique le pourcentage. Les nouveaux pourcentages sont lus depuis l'entrée standard, un entier par ligne. La barre est mise à jour pour refléter chaque nouveau pourcentage. Si stdin est la chaîne « XXX », les lignes suivantes avec « XXX » sont utilisées pour une nouvelle invite. Ce dialogue s'arrête lorsque EOF est rencontré sur stdin. La valeur [i]percent[/i] indique le pourcentage initial à montrer dans la barre. Si non spécifié, il est à zéro. .[/col][/row][/table] "[b][/b]--infobox [i]texte[/i] hauteur largeur" [table][row][col]    [/col][col]Un boîte [b]info[/b] est basiquement une boîte [b]message[/b]. De toute manière, dans ce cas, [b]dialog[/b] sortira immédiatement après avoir affiché le message pour l'utilisateur. L'écran n'est pas effacé quand [b]dialog[/b] s'arrête, ainsi le message restera visible à l'écran jusqu'à un nouvel appel du script shell pour l'effacer ultérieurement. Ceci est utile lorsque vous souhaitez informer l'utilisateur d'une opération effectuée qui ne requiert pas son intervention pour continuer ou terminer. .[/col][/row][/table] "[b][/b]--inputbox [i]texte[/i] hauteur largeur [init]" [table][row][col]    [/col][col]Cette boîte est utile lorsque vous voulez poser une question qui nécessite une réponse de l'utilisateur sous forme d'une chaîne de caractères. Si init est indiqué il sera utilisé comme valeur initiale de la chaîne. En saisissant la réponse, il est possible d'employer la touche [i]BACKSPACE[/i] pour corriger les erreurs de frappe. Si la chaîne saisie est plus longue que la zone, le champ sera déroulé. À la sortie, la chaîne sera envoyée sur [b]stderr .[/b] .[/col][/row][/table] "[b][/b]--inputmenu [i]texte[/i] hauteur largeur hauteur-du-menu [ [i]marqueur[/i] item ] [i]..."[/i] [table][row][col]    [/col][col]Une boîte [b]inputmenu[/b] est très similaire à une boîte [b]menu[/b] ordinaire. Il n'y a que peu de différences entre elles :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col]1. Les entrées ne sont pas automatiquement centrées mais alignées à gauche.[/col][/row][/table] [table][row][col]    [/col][col]2. Un bouton supplémentaire (appelé [i]Rename[/i]) est disponible pour renommer l'élément actuel lorsqu'il est choisi.[/col][/row][/table] [table][row][col]    [/col][col]3. Il est possible de renommer l'entrée actuelle en pressant le bouton [i]Rename[/i]. Ensuite dialog écrira le résultat suivant sur [b]stderr :[/b] RENAMED <marqueur> <item>[/col][/row][/table] .[/col][/row][/table] "[b][/b]--menu [i]texte[/i] hauteur largeur hauteur-du-menu [ [i]marqueur1[/i] item1 ] [i]..."[/i] [table][row][col]    [/col][col]Comme son nom l'indique, une boîte [b]menu[/b] est une boîte de dialogue qui peut être utilisée pour présenter une liste de choix sous la forme d'un menu pour que l'utilisateur fasse une sélection. Les choix sont affichés dans l'ordre donné. Chaque entrée de menu consiste en une chaîne [i]élément[/i] et une chaîne [i]item[/i]. Le [i]marqueur[/i] donne un nom symbolique à l'item pour le distinguer parmi les autres dans le menu. L'[i]item[/i] est un nom court décrivant l'option que l'entrée représente. L'utilisateur peut se déplacer en utilisant les touche monter/descendre, la première lettre du [i]marqueur[/i] comme touche de raccourci, l'une des touches [b]1-9 .[/b] [i]menu-height[/i] les éléments sont affichés dans le menu en même temps, mais peuvent être déroulés si d'autres éléments ne peuvent figurer en fonction de la taille de la boîte. Lorsque [b]dialog[/b] se termine, le [i]marqueur[/i] de l'élément choisi est imprimé sur [b]stderr .[/b] Si l'option [b][/b]--help-button est donnée, le texte d'aide correspondant sera imprimé si l'utilisateur appuie sur ce bouton. .[/col][/row][/table] "[b][/b]--msgbox [i]texte[/i] hauteur largeur" [table][row][col]    [/col][col]Une boîte [b]message[/b] est très similaire à une boîte [b]yes/no[/b] (oui/non). La seule différence entre une boîte [b]message[/b] et une boîte [b]yes/no[/b] est que la boîte [b]message[/b] n'a que le seul bouton [b]OK[/b]. Vous pouvez utiliser ce dialogue pour afficher un message quelconque. Après lecture du message, l'utilisateur peut appuyer sur la touche [i]ENTER[/i] (retour chariot) qui permet au script shell de continuer ses opérations. .[/col][/row][/table] "[b][/b]--passwordbox [i]texte[/i] hauteur largeur [init]" [table][row][col]    [/col][col]Cette boîte est similaire à une boîte inputbox, sauf que le texte que l'utilisateur entre n'est pas affiché. Ceci est particulièrement utile pour demander un mot de passe ou autre information sensible. Attention, si une valeur « init » est donnée, elle sera visible dans la table des process du système lors d'une requête d'interrogation. De même, il est perturbant pour l'utilisateur de lui donner la valeur secrète qu'il lui est demandé de fournir, alors même qu'il ne peut la voir. Pour ces raisons, l'usage de « init » est fortement décommandé. .[/col][/row][/table] "[b][/b]--radiolist [i]texte[/i] hauteur largeur hauteur-de-liste [ [i]marqueur1[/i] item1 état ] [i]..."[/i] [table][row][col]    [/col][col]Une boîte [b]radiolist[/b] est similaire à une boîte [b]menu[/b]. La seule différence est que vous pouvez indiquer quel élément est actuellement sélectionné en positionnant son [b]état à on .[/b] .[/col][/row][/table] "[b][/b]--tailbox [i]fichier[/i] hauteur largeur" [table][row][col]    [/col][col]Affiche un texte depuis un fichier dans une boîte de dialogue, comme avec la commande « tail -f ». .[/col][/row][/table] "[b][/b]--tailboxbg [i]fichier[/i] hauteur largeur" [table][row][col]    [/col][col]Affiche un texte depuis un fichier dans une boîte de dialogue en tâche de fond, comme avec la commande « tail -f & ». Défilement gauche/droite en utilisant le style vi 'h' et 'l', ou les touches fléchées. Un '0' réinitialise le défilement.[/col][/row][/table] [table][row][col]    [/col][col]Dialog traite la tâche de fond spécialement si d'autres fonctions sont utilisées ([b][/b]--and-widget) sur l'écran en concurence. Jusqu'à ce que ces fonctions se terminent (avec « OK » par exemple), dialog exécutera toutes les fonctions tailboxbg dans le même process, en procédant aux mises à jour. Vous pouvez utiliser la tabulation pour parcourir les fonctions disponibles à l'écran, et les fermer individuellement, par exemple en appuyant sur [i]ENTER[/i]. Une fois toutes les fonctions non tailboxbg fermées, dialog fork une copie de lui-même en tâche de fond, et imrime son process-id si l'option [b][/b]--no-kill est donnée.[/col][/row][/table] [table][row][col]    [/col][col]NOTE : D'anciennes versions de dialog forkent immédiatement et tentent de mettre à jour l'écran individuellement. En plus d'être peu performant, ça ne marche pas. Certains anciens scripts peuvent ne pas fonctionner correctement avec ce mode. .[/col][/row][/table] "[b][/b]--textbox [i]fichier[/i] hauteur largeur" [table][row][col]    [/col][col]Une boîte [b]textbox[/b] vous permet d'afficher le contenu d'un fichier texte dans une boîte de dialogue. C'est comme un simple visualiseur de fichier texte. L'utilisateur peut se déplacer dans le fichier en utilisant les touches habituelles de déplacement. Si les lignes sont trop longues pour pouvoir être affichées dans la boîte, les touches [i]DROITE/GAUCHE[/i] peuvent être utilisées pour faire défiler le texte horizontalement. Vous pouvez aussi utiliser les touche du style vi h, j, k, l au lieu des touches curseur, et B ou N au lieu des touches du déplacement par page. Défilement monter/descendre en utilisant le style vi 'k' et 'j', ou les touches fléchées. Défilement gauche/droite en utilisant le style vi 'h' et 'l', ou les touches fléchées. Un '0' réinitialise le défilement gauche/droite. Pour plus de commodité, le style vi de recherche avant ou arrière est aussi utilisable. .[/col][/row][/table] "[b][/b]--timebox [i]texte[/i] hauteur [largeur heure minute seconde]" [table][row][col]    [/col][col]Un dialogue est affiché qui vous permet de sélectionneur heure, minute et seconde. Si la valeur de l'heure, minute ou seconde est manquante ou négative, la date courante à la valeur correspondante est utilisée. Vous pouvez augmenter ou diminuer l'une d'elles un utilisant le touches fléchées. Utilisez la tabulation ou son inverse pour vous déplacer entre les zones. En sortie, le résultat est imprimé sous la forme heure:minute:seconde. .[/col][/row][/table] "[b][/b]--yesno [i]texte[/i] hauteur largeur" [table][row][col]    [/col][col]Une boîte de dialogue [b]yes/no[/b] (oui/non) de la taille de [i]height[/i] lignes par [i]width[/i] colonnes sera affichée. La chaîne indiquée par [i]text[/i] est affichée dans la boîte de dialogue. Si cette chaîne est trop longue pour tenir sur une ligne, elle sera automatiquement divisée en plusieurs lignes aux emplacements appropriés. La chaîne [i]text[/i] peut aussi contenir la sous-chaîne .I "en" ou des caractères newline [i]`[/i]en' pour contrôler les ruptures de ligne explicitement. Cette boîte de dialogue est utile pour poser des questions qui nécessitent une réponse de l'utilisateur par oui ou non. La boîte de dialogue a un bouton [b]Yes[/b] (oui) et un bouton [b]No[/b] (non), que l'utilisateur peut sélectionner par la touche [b]TAB .[/b] .[/col][/row][/table] [size=18] [b]Configuration dexÉcution[/b] [/size] [table][row][col]    [/col][col]1. Créez un fichier de configuration exemple par :[/col][/row][/table]     .in +1i "dialog --create-rc <fichier>" [table][row][col]    [/col][col]2. Au lancement, [b]dialog[/b] determine les paramètres à utiliser de la manière suivante :[table][row][col]    [/col][col][/col][/row][/table] [table][row][col]    [/col][col]a) si la variable d'environnement [b]DIALOGRC[/b] est utilisée, sa valeur détermine le nom du fichier de configuration.[/col][/row][/table] [table][row][col]    [/col][col]b) si le fichier en (a) n'est pas trouvé, utilise le fichier [i]$HOME/.dialogrc[/i] comme fichier de configuration.[/col][/row][/table] [table][row][col]    [/col][col]c) si le fichier en (b) n'est pas trouvé, essaye d'utiliser le fichier GLOBALRC déterminé au moment de la compilation, [i]/etc/dialogrc[/i] par exemple.[/col][/row][/table] [table][row][col]    [/col][col]d) si le fichier en (c) n'est pas trouvé, utilise les paramètres compilés par défaut.[/col][/row][/table][/col][/row][/table] [table][row][col]    [/col][col]3. Éditez le fichier de configuration exemple et copiez-le quelque part où [b]dialog[/b] pourra le trouver, comme indiqué au 2 ci-dessus. .[/col][/row][/table] [size=18] [b]Environnement[/b] [/size] [table][row][col]    [/col][col][b]DIALOGRC[/b] Definissez cette variable si vous souhaitez spécifier le nom du fichier de configuration à utiliser.[/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_CANCEL[/b][/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_ERROR[/b][/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_ESC[/b][/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_EXTRA[/b][/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_HELP[/b][/col][/row][/table] [table][row][col]    [/col][col][b]DIALOG_OK[/b] Definissez l'une ou l'autre de ces variables pour changer le code retour pour Cancel (1), error (-1), ESC (255), Extra (3), Help (2), ou Ok (0). Normalement, les scripts shell traitent de -1 à 255.[/col][/row][/table] [size=18] [b]Fichiers[/b] [/size] [table][row][col]    [/col][col][i]$HOME/.dialogrc[/i] fichier de configuration par défaut[/col][/row][/table] [size=18] [b]Exemples[/b] [/size] Les sources de dialog contiennent plusieurs exemples de la manière d'utiliser les différentes options et ce qu'elles produisent. Voyez donc le répertoire [b]samples/[/b] dans les sources. [size=18] [b]Diagnostiques[/b] [/size] Le code de retour est sujet à modification par les variables d'environnement. Normalement, ce sont : [table][row][col]    [/col][col]0 si [b]dialog est quitté en appuyant sur le bouton « Yes » ou « OK »[/b] (oui ou OK).[/col][/row][/table] [table][row][col]    [/col][col]1 si le bouton [b]No ou Cancel[/b] (non ou annuler) est appuyé.[/col][/row][/table] [table][row][col]    [/col][col]2 si le bouton [b]Help[/b] (aide) est appuyé.[/col][/row][/table] [table][row][col]    [/col][col]3 si le bouton [b]Extra[/b] est appuyé.[/col][/row][/table] [table][row][col]    [/col][col]-1 si des erreurs se produisent dans [b]dialog[/b] ou que [b]dialog[/b] est quitté en appuyant sur la touche [i]ESC[/i]. .[/col][/row][/table] [size=18] [b]Bogues[/b] [/size] Peut- être. [size=18] [b]Auteurs[/b] [/size] Savio Lam (lam836@cs.cuhk.hk) - version 0.3, "dialog"     Stuart Herbert (S.Herbert@sheffield.ac.uk) - patch for version 0.4     Pako (demarco_p@abramo.it) - version 0.9a, "cdialog",     Thomas Dickey (updates for 0.9b) [size=18] [b]Contributeurs[/b] [/size] Tobias C. Rittweiler (tobrit@freebits.de) [size=18] [b]Traduction[/b] [/size] F.A. Van Den Bussche (fa point vdb chez free point fr) [size=18] [b]Traduction[/b] [/size] Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.
Fichier