Différences

Ci-dessous, les différences entre deux révisions de la page.

--- yad_yet_another_dialog [Le 20/04/2016, 11:06]
78.250.183.168 [États de sorties]
+++ yad_yet_another_dialog [Le 28/09/2022, 21:04] (Version actuelle)
Amiralgaby correction de certain script shell repéré grâce à wiki-corrector
@@ Ligne 1: / Ligne 1: @@
-{{tag>wiki}}
+{{tag>console shell }}
-----
-{{tag>Trusty BROUILLON}}
 ----
@@ Ligne 8: / Ligne 7: @@
 //Traduction de la description sur le site officiel de Yad.// ((YAD (yet another dialog) is a tool for create graphical dialogs from shell scripts))
-**Yad** (encore une boîte de dialogue) est un outil pour créer des boîtes de dialogue graphiques à partir de scripts shell.
+**Yad** (« Yet Another Dialog », « encore une boîte de dialogue ») est un outil pour créer des boîtes de dialogue graphiques à partir de scripts shell.
-**Yad** est un fork de [[:Zenity|Zenity]]
+**Yad** est un fork de [[:Zenity|Zenity]].
+Ses avantages par rapport à Zenity sont l'intégration de plusieurs contrôles sur une même fenêtre (voir le paramètre %%--%%form)
+===== Auteurs =====
+Yad a été écrit par Victor Ananjevsky.
+L'icone Yad a été créé par Bogdan Lisovich.
 ===== Pré-requis =====
@@ Ligne 18: / Ligne 23: @@
 ===== Installation =====
+==== Version des dépôts ====
 Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>yad]]**.
-<note>
+==== Avec un ppa ====
-Yad évolue très vite, il peut être utile de compiler la dernière version.
+Pour installer une version récente de YAD, vous pouvez installer YAD avec le PPA de webupd8, en une ligne :
+<code>sudo add-apt-repository ppa:nilarimogard/webupd8 -y && sudo apt update && sudo apt install yad -y</code>
+==== Par compilation ====
+< Pour les utilisateurs avancés >
+**Yad** évolue très vite, il peut être utile de compiler la dernière version.
 Pour satisfaire les dépendances, installez Yad par APT puis si vous voulez la dernière version, compilez-la comme suit.
-</note>
+Vous devrez peut-être installer gcc,  libwebkitgtk-dev
 Pour avoir la dernière version, télécharger l'archive sur [[https://sourceforge.net/projects/yad-dialog/|la page officielle de Yad]]
 Décompressez-la ou vous voulez.
@@ Ligne 36: / Ligne 48: @@
 </code>
  <note>
-L'auteur fourni une petite application qui permet de lister les icones pouvant être utilisées.
+L'auteur fourni une petite application qui permet de lister les icônes pouvant être utilisées.
-Il vous faut également activer le widget --html.
+Il vous faut également activer le widget %%--%%html.
 Procèder comme suit pour les installer.
 </note>
@@ Ligne 46: / Ligne 58: @@
 sudo make install
 </code>
-===== Configuration =====
-A complèter
 ===== Utilisation =====
+==== Types de fenêtres ====
 Yad permet d'afficher plusieurs types de fenêtre :
 ^ Type de fenêtre       ^ Argument         ^ Description                      ^
-| Par défaut |                             | Affiche une boîte de dialogue (Peut être utilisé pour des informations ou des erreurs.).|
 | Sélection            |''%%--calendar%%''   | Affiche un calendrier           |
 | Sélection                |''%%--color%%''      | Affiche un sélecteur de couleur  |
@@ Ligne 64: / Ligne 72: @@
 | Entrée |''%%--entry%%''| Affiche une boîte de saisie|
 | Entrée |''%%--scale%%''| Affiche un bouton glissant|
+| Affichage |                             | Affiche une boîte de dialogue (Peut être utilisé pour des informations ou des erreurs.).|
 | Affichage                  |''%%--icons%%''       | Pas encore testé         |
 | Affichage              |''%%--html%%''   | Affiche un navigateur|
 | Affichage            |''%%--list%%''   | Affiche une liste|
-| Affichage         |''%%--multi-progress%%''     | Affiche plusieurs barres de progresion       |
+| Affichage         |''%%--multi-progress%%''     | Affiche plusieurs barres de progression       |
 | Affichage                 |''%%--notification%%''       | Affiche une icone dans la zone de notification     |
 | Affichage                |''%%--progress%%''      | Affiche une barre de progression  |
 | Affichage               |''%%--text-info%%''      | Affiche le contenu d'un fichier texte     |
-| Multiples              |''%%--form%%''   | Affiche une multitude de boîte |
+| Affichage               |''%%--picture%%''      | Un simple visionneur d'images     |
+| Multiples              |''%%--form%%''   | Affiche une multitude de champs |
 | Multiples                 |''%%--notebook%%''       | Affiche une boîte avec des onglets |
 | Multiple |''%%--paned%%''| Affiche une boîte en deux parties|
@@ Ligne 78: / Ligne 88: @@
 [[http://manpages.ubuntu.com/manpages/wily/man1/yad.1.html|Pour plus d'infos, consulter les pages du manuel de Yad.]]
+==== Types de champs de la fenêtre form (formulaire) ====
+Les formulaires permettent de décliner les différentes options de yad dans la même fenêtre.
+Les types de champs de formulaire sont saisis sous la forme
+%%--%%field="LABEL"[:TYPE]
+Les types de champs sont les suivants : H, RO, NUM, CHK, CB, CBE, CE, FL, SFL, DIR, CDIR, FN, MFL, MDIR, DT, SCL, CLR, BTN, FBTN, LBL, TXT.            ||
+^Type de champ^ Utilisation^
+|            |Les entrées de formulaire non typées sont traitées comme des entrées texte simple (Type CE).|
+|BTN            |Champ bouton libre. L’étiquette du bouton est un texte saisi selon la convent d’écriture suivante : Etiquette[!Icone[!Infobulle]]. Le séparateur est le caractère !. (point d’exclamation). L’étiquette est un texte ou un identifiant gtk. Icône est un fichier icône (identifiant ou nom de fichier). L’infobulle est un paramètre optionnel correspondant à une fenêtre surgissante d’aide qui apparaît au survol du bouton. Il est possible d’affecter une commande au bouton. Dans ce cas, le symbole spécial%N d’une commande est remplacé par la valeur du champ N. Si la commande débute par le caractère @ (arobase), la sortie de la commande sera parsée et les lignes qui débutent par des nombres et des colonnes seront traitées comme les valeurs de nouveaux champs.|
+|CB            |Boîte déroulante. Les valeurs possibles sont saisies sous la forme VAL1!VAL2 !… Le séparateur est identique au séparateur des champs numériques. La valeur précédée du caractère ∧ correspond à la valeur par défaut.|
+|CBE            |Boîte déroulante éditable. Valeurs initiales saisies selon les mêmes règles que pour la boîte déroulante standard. D'autres valeurs que les valeurs proposées peuvent être saisies.|
+|CDIR            |Bouton de sélection ou de création de répertoire.|
+|CE            |Texte libre. Correspond au type de champ par défaut.|
+|CHK            |Case à cocher. La valeur initiale est une constante insensible à la casse (TRUE ou FALSE)|
+|CLR            |Boîte de sélection de couleur. La valeur par défaut de la couleur peut être saisie au format hexadécimal (#FF0000 par exemple). La boîte de dialogue est moins sophistiquée que le champ yad –color qui affiche une roue des couleurs et des champs de saisie numérique.|
+|DIR            |Bouton de sélection de répertoire dans l’arborescence. Ne permet pas la saisie d’un nom de répertoire qui ne figure pas dans l’arborescence (voir option CDIR).|
+|DT            |Champ date.|
+|FBTN            |Identique au champ BTN, le bouton étant en relief.|
+|FL            |Bouton de sélection de fichier dans l’arborescence. Ne permet pas la saisie d’un nom de fichier qui ne figure pas dans l’arborescence (voir option SFL).|
+|FN            |Boîte de sélection de police de caractère. Les polices de caractère sont saisies sous la forme Famille Style Taille (exemple : Sans Bold 13). La boîte de dialogue est moins sophistiquée que le champ yad –font.|
+|H            |Champ caché. Tous les caractères saisis apparaissent sous la forme d’un caractère invisible (souvent un point). Permet la saisie discrète d’un mot de passe.|
+|LBL            |Étiquette. Si le nom du champ est vide, un séparateur linéaire horizontal apparaîtra dans le formulaire.|
+|MDIR            |Bouton de sélection de plusieurs répertoires dans l’arborescence. Les noms de répertoires apparaîtront séparés par des virgules. Ne permet pas la saisie d’un nom de répertoires qui ne figure pas dans l’arborescence.|
+|MFL            |Bouton de sélection de plusieurs fichiers dans l’arborescence. Les noms de fichiers apparaîtront séparés par des virgules. Ne permet pas la saisie d’un nom de fichier qui ne figure pas dans l’arborescence.|
+|NUM            |Valeur numérique. Formatage possible : Valeur[!Echelle[!Pas[!Précision]]]. L’échelle des valeurs se présente sous la forme Min..Max. La précision concerne les décimales.|
+|RO            |Champ en mode lecture seule.|
+|SCL            |Échelle (réglette). Valeur comprise entre 0 et 100.|
+|SFL            |Bouton de sélection ou de création de fichier.|
+|TXT            |Entrée texte multiligne. Occupe l’ensemble de la surface du formulaire.|
 ===== Exemples =====
-[[https://code.google.com/archive/p/yad/wikis|Quelques exemples sur cette page]]
+Avant de vous lancer dans la lecture, notez que vous trouverez de nombreux exemples, simples et complexes avec ces liens :
+  * [[http://smokey01.com/yad|Apprendre par l'exemple]] ([[https://www.dropbox.com/s/56k5ta6j52r9inu/yad.pdf|copie en PDF]])
+  * [[https://code.google.com/archive/p/yad/wikis|Applications simples]]
 ====--calendar====
 Dans cet exemple le calendrier s'ouvrira à la date du jour et la sortie sera de format sam./27/juil./2019/
---title="Titre de la fenêtre": Indique le titre de votre fenêtre.
+%%--%%title="Titre de la fenêtre": Indique le titre de votre fenêtre.
---window-icon="yad": Affiche une icone dans la barre du titre (Selon votre thème.) et sur le bouton de la liste des fenêtres.
+%%--%%window-icon="yad": Affiche une icône dans la barre du titre (Selon votre thème.) et sur le bouton de la liste des fenêtres.
 <code>
 jour=$(date +%d)
@@ Ligne 110: / Ligne 150: @@
 #!/bin/bash
 recherche=$(yad --entry --title='Recherche web' --text='Tapez votre recherche' --text-align="center" --no-escape --mouse --undecorated --skip-taskbar --on-top)
-recherche=$(echo "$recherche" | sed 's/ /+/g')
+recherche=${recherche// /+}
-xdg-open https://www.google.fr/search?q="$recherche"\&site=webhp\&source=lnt\&tbs=lr:lang_1fr\&lr=lang_fr
+xdg-open "https://www.google.fr/search?q=$recherche&site=webhp&source=lnt&tbs=lr:lang_1fr&lr=lang_fr"
 </code>
 ====--form====
-C'est ici que Yad devient intêressant car il permet de cumuler plusieurs types de boîtes dans une seule fenêtre.
+C'est ici que Yad devient intéressant car il permet de cumuler plusieurs types de boîtes dans une seule fenêtre.
-Si l'on reprend l'exemple précédent vous pouvez entrer votre recherche et choisir le moteur le plus approprié.
+Deux exemples récapitulatifs :
+<code>
+retour=$(yad --form --field="BTN":BTN  --field="CB":CB  --field="CBE":CBE  --field="CDIR":CDIR  --field="CE":CE  --field="CHK":CHK  --field="CLR":CLR  --field="DIR":DIR  --field="DT":DT  --field="FBTN":FBTN  --field="FL":FL  --field="FN":FN  --field="H":H "gtk-cancel:1" "Valeur 1\!Valeur 2\!^Valeur 3\!Valeur 4" "Valeur 1\!Valeur 2\!Valeur 3\!Valeur 4" "/home/user/Documents/" "Texte libre." "TRUE" "#FA892F" "/home/user/Documents/" "12/11/2018" "Firefox" "/home/user/Documents/fichier.txt" "Sans Bold 12" "motdepasse")
+echo "$retour"
+</code>
+{{::yad.1.png?300|}}
+et (un seul formulaire avec toutes les options risque de dépasser les dimensions de votre écran) :
+<code>
+retour=$(yad --form  --field="LBL":LBL  --field=:LBL  --field="MDIR":MDIR  --field="MFL":MFL  --field="NUM":NUM  --field="RO":RO  --field="SCL":SCL  --field="SFL":SFL  --field="TXT":TXT  --field="Champ dépourvu d'option : '" "Une étiquette" "" "/home/user/Documents/,/home/user/Musique" "/home/user/Documents/fichierun.txt,/home/user/Documents/fichierdeux.txt" "10.00\!0..1000\!0.05\!2" "Lecture seule" "27" "/home/user/NouveauFichier.txt" "Texte multiligne" "Valeur par défaut : texte simple")
+echo "$retour"
+</code>
+{{::yad2.png?500|}}
+<note tip>Voir [[https://doc.ubuntu-fr.org/yad_yet_another_dialog#recuperer_les_sorties_dans_les_boites_multiples|Récupérer les sorties dans les boites multiples]] ci dessous pour récupérer les valeurs des différents champs du formulaire dans un tableau.</note>
+Si l'on reprend l'exemple précédent vous pouvez entrer votre recherche et choisir le moteur le plus approprié :
 <code>
 #!/bin/bash
@@ Ligne 121: / Ligne 178: @@
 --form \
 --field="recherche:" '' \
---field="Moteur:CB" 'Forum ubuntu!^Google fr!Google world!Wikipedia fr!Dvdfr.com!Themoviedb.org')
+--field="Moteur:CB" 'Forum ubuntu!^Google fr')
-rech=$(echo $search | awk 'BEGIN {FS="|" } { print $1 }')
+rech=$(echo "$search" | awk 'BEGIN {FS="|" } { print $1 }')
-moteur=$(echo $search | awk 'BEGIN {FS="|" } { print $2 }')
+moteur=$(echo "$search" | awk 'BEGIN {FS="|" } { print $2 }')
 if [ "$moteur" = "Forum ubuntu" ]
 then
 rech=$(echo "$rech" | sed 's/^/+/;s/ /+/g')
 xdg-open https://www.google.fr/search?q=site:forum.ubuntu-fr.org"$rech"
-elif  [ "$moteur" = "Google world" ]
+elif  [ "$moteur" = "Google fr" ]
 then
 rech=$(echo "$rech" | sed 's/^/+/;s/ /+/g')
-xdg-open https://www.google.fr/search?channel=fs\&q="$rech"\&ie=utf-8\&oe=utf-8\&gfe_rd=cr\&ei=lJgUV72ZB4aGtgf0iKeYBA
+xdg-open https://www.google.fr/search?q="$rech"\&lr=lang_fr
+fi
+</code>
+====--notification====
+Affiche une icône dans la zone de notification du panel (le systray).
+Un exemple concret tout simple, qui affiche une icône et quitte lorsqu'on clique gauche dessus :
+<code>yad --notification</code>
+On peux changer l’icône avec le paramètre **%%--%%image**
+<code>yad --notification --image="gtk-help"</code>
+<code>yad --notification --image="system-software-update"</code>
+Exemple avec un script faisant les mises à jour et affichant avec une icône dans la zone de notification pour le signaler :
+<code>
+#!/bin/bash
+MSG="Mise à jour du système en cours, n'éteignez pas l'ordinateur..."
+notify-send "$MSG"
+faireMaJ () { (sudo apt update ; sudo apt full-upgrade) > /dev/null; }
+faireMaJ | yad --notification --no-middle --text="$MSG" --image="system-software-update" --command="zenity --info --text \"$MSG\"" --listen
+</code>
+{{::yad.3.png?400|}}
+La liste des noms d’icônes standard sont là : [[https://wiki.gnome.org/Attic/GnomeArt/Tutorials/IconThemes#Step_3._Icon_naming_.26_organization|LIEN]]
+Quelques exemples du site officiel : [[https://sourceforge.net/p/yad-dialog/wiki/NotificationIcon/|LIEN]]
+Reprenons l'exemple d'avant et mettons-le dans une icône.
+<code>
+#!/bin/bash
+#####Commande qui permet de montrer/cacher la fenêtre
+function _commande ()
+{
+commande=$(ps -ef | grep "yad --title=Recherche web --text=Tapez votre recherche" | sed 's/^.*grep.*$//' | sed -n "1p" | awk 'BEGIN { FS=" " } { print $2 }')
+if [ -n "$commande" ]
+then
+kill -9 "$commande"
+else
+_recherche
+fi
+}
+export -f _commande
+#####Recherche internet
+function _recherche ()
+{
+search=$(yad --title='Recherche web' --text='Tapez votre recherche' --text-align="center" --no-escape --mouse --undecorated --skip-taskbar --on-top \
+--form \
+--field="recherche:" '' \
+--field="Moteur:CB" 'Forum ubuntu!^Google fr')
+rech=$(echo "$search" | awk 'BEGIN {FS="|" } { print $1 }')
+moteur=$(echo "$search" | awk 'BEGIN {FS="|" } { print $2 }')
+if [ "$moteur" = "Forum ubuntu" ]
+then
+rech=$(echo "$rech" | sed 's/^/+/;s/ /+/g')
+xdg-open https://www.google.fr/search?q=site:forum.ubuntu-fr.org"$rech"
 elif  [ "$moteur" = "Google fr" ]
 then
-rech=$(echo "$rech" | sed 's/ /+/g')
+rech=$(echo "$rech" | sed 's/^/+/;s/ /+/g')
 xdg-open https://www.google.fr/search?q="$rech"\&lr=lang_fr
-elif  [ "$moteur" = "Wikipedia fr" ]
+fi
+}
+export -f _recherche
+#####lancement
+yad --notification --no-middle --title="Recherche internet" --command="bash -c _commande" --text="Recherche internet" --image="search" --menu='Quitter!quit!exit'
+</code>
+====--notebook====
+Une boite à onglets.
+<code>
+#!/bin/bash
+#####ID --KEY Création aléatoire de l'id
+id=$(($RANDOM % ($((10000 - 32000)) + 1) + 10000))
+##########Onglet 1##########
+#####Avec une colonne#######
+yad --plug="$id" --tabnum=1 --form --columns="1" --item-separator='!' --focus-field="1" --dialog-sep --align="center" \
+--field="Fichier d'entrée:FL" "$HOME" \
+--field=":LBL" "" \
+--field="Fichier de sortie:SFL" "" \
+&> /tmp/data1 &
+##########Onglet 2##########
+#####Avec 3 colonnes########
+yad --plug="$id" --tabnum=2 --form --columns="3" --item-separator='!' --focus-field="2" --dialog-sep --align="center" \
+--field="<span weight='Bold' foreground='black'>Du texte.</span>:LBL" "" \
+--field="motif:" "" \
+--field="bouton avec relief:FBTN" '' \
+--field="Bouton sans relief:BTN" '' \
+--field="bouton avec relief:FBTN" '' \
+--field="Bouton sans relief:BTN" '' \
+&> /tmp/data2 &
+yad --notebook --width="900" --height="700" --center --title="yad notebook" --window-icon="gnome-util" --key="$id" \
+--tab="onglet 1" --tab="Onglet 2" \
+--button="gtk-cancel:1" \
+--button="gtk-ok:0"
+fermernotebook=$?
+if [ $fermernotebook -eq 252 ]
 then
-xdg-open https://fr.wikipedia.org/wiki/"$rech"
+exit
-elif  [ "$moteur" = "Dvdfr.com" ]
+elif [ $fermernotebook -eq 1 ]
 then
-rech=$(echo "$rech" | sed 's/ /+/g')
+exit
-xdg-open http://www.dvdfr.com/search/multisearch.php?multiname="$rech"\&x=0\&y=0
-elif  [ "$moteur" = "Themoviedb.org" ]
-then
-rech=$(echo "$rech" | sed 's/ /+/g')
-xdg-open https://www.themoviedb.org/search?language=fr-FR\&query="$rech"
 fi
 </code>
-===== Trucs et astuces =====
+====--list====
-==== États de sorties=====
+Des cases à cocher.
-L'utilisateur a appuyé sur le bouton OK
+Choisir un item dans une liste :
+<code>
+#!/bin/bash
+# Affichage du contenu du fichier sélectionné
+function usage {
+echo "Affichage du contenu du fichier sélectionné"
+echo "Un unique fichier sélectionné"
+echo "affichage par cat"
+}
+if [[ "$1" == "-h" ]] || [[ "$1" == "-help" ]] || [[ "$1" == "-aide" ]]; then
+  usage
+else
+  retour=$(yad --title="Fichier à afficher" --width 800 --height 200 --text-align="center" --list --radiolist --column="Sélectionné" --column="Fichier" --column="Mis à jour" --column="Utillisé" False "$HOME/Documents/FichierUn" "Non" "Non" False "$HOME/Documents/FichierDEux" "Oui" "Non" True "$HOME/Documents/FichierTrois" "Oui" "Non")
+  cat "$(echo "$retour" | cut -d'|' -f2)"
+fi
+</code>
+{{ :yad_disco_00_radiolist.png?direct&800 |}}
+Et pour pourvoir sélectionner plusieurs lignes à la fois :
+<code>
+retour=$(yad --title="Fichier à afficher" --width 800 --height 200 --text-align="center" --list --checklist --column="Sélectionné" --column="Fichier" --column="Mis à jour" --column="Utillisé" False "/home/usr/Documents/FichierUn" "Non" "Non" False "/home/usr/Documents/FichierDEux" "Oui" "Non" True "/home/usr/Documents/FichierTrois" "Oui" "Non")
+lesFichiers=$(echo "$retour" | cut -d'|' -f2)
+for i in $lesFichiers; do
+  cat "$i";
+done
+</code>
+{{ :yad_disco_01_checklist.png?direct&800 |}}
+<note tip>Bien qu'étant qualifiée d'obsolète par certains sites, l'option --radiolist permet donc de limiter la sélection à un seul choix quand --checklist permet d'en faire plusieurs. Une autre manière de pouvoir sélectionner plusieurs items sans afficher de case à cocher consite à utiliser l'option --multiple avec --list.</note>
+===== Pango Markup Language - mettre en forme un texte =====
+Le langage de Markup Pango est un langage de mise en forme très simple qui est supporté par Yad. Il permet de mettre en forme le texte via des balises <span></span>.
+Quelques balises inspirées du html existent aussi (sans balise <span>) : <b> pour gras, <u> pour souligné ...
-L'utilisateur a appuyé sur le bouton Annuler
+La liste des balises autorisées se trouvent ici : [[https://developer.gnome.org/pygtk/stable/pango-markup-language.html]]
+Exemples :
-La boîte de dialogue a été fermée parce que le délai d'attente a été atteint. (Dans le cas d'un timeout)
+**font_desc** : ''%%--%%text="une <span font_desc='Sans italic 10'>Maison</span> neuve"'' affiche le mot **maison** dans une police ''sans'', en italique, avec une taille de 10.
+**font_desc** : ''%%--%%text="une <span font_desc='Sans italic 10' strikethrough='true'>Maison</span> neuve"'' affiche le mot **maison** dans une police ''sans'', en italique, avec une taille de 10 et barrée (strikethrough)
-La boîte de dialogue a été fermé en appuyant sur la touche Echap ou en cliquant sur le bouton de fermeture de la barre du titre de la boîte de dialogue
+**souligné** : ''%%--%%text="une <u>Maison</u> neuve"'' affiche le mot **maison** en souligné.
+===== Trucs et astuces =====
+==== États de sorties====
+Voilà le code (testable) renvoyé par **yad** quand on appuie sur certains boutons pour quitter une boite de dialogue :
+**0** : L'utilisateur a appuyé sur le bouton OK
+**1** : L'utilisateur a appuyé sur le bouton Annuler
+**70** : La boîte de dialogue a été fermée parce que le délai d'attente a été atteint. (Dans le cas d'un timeout)
+**252** : La boîte de dialogue a été fermée en appuyant sur la touche Echap ou en cliquant sur le bouton de fermeture de la barre du titre de la boîte de dialogue
@@ Ligne 184: / Ligne 368: @@
 echo "$?"
 </code>
-Comme vous le constaté la fenêtre se ferme mais le script continu.
+Comme vous le constatez la fenêtre se ferme mais le script continu.
 Personnellement lorsque je clique sur le bouton de fermeture, le bouton Annuler ou la touche Echap je veux arrêter le script.
@@ Ligne 190: / Ligne 374: @@
 Pour ce faire nous allons utiliser la [[:tutoriel/script_shell#les_variables|variable bash]] $? qui contient le code de retour de la dernière opération.
-j'utilise [[:tutoriel/script_shell#la_structure_case|la structure case]] mais Il existe d'autre méthodes.
+Je me sers de [[:tutoriel/script_shell#la_structure_case|la structure case]] mais Il existe d'autres méthodes.
 <code>
 #!/bin/bash
@@ Ligne 207: / Ligne 391: @@
 echo "$?"
 </code>
-===== Désinstallation =====
-Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
-===== Voir aussi =====
-  * **(en)** [[https://sourceforge.net/projects/yad-dialog|Site officiel du logiciel]]
-  * **(en)** [[https://groups.google.com/forum/#!forum/yad-common|Forum de discution du logiciel. L'auteur y participe souvent.]]
-----
-//Contributeurs principaux : [[sergeG75018]].//
-//Basé sur [[http://manpages.ubuntu.com/manpages/wily/man1/yad.1.html|« les pages du manuel »]].//
+====Les boutons.====
+===Comportements===
+Il y a deux types de comportements:
-===== Auteurs =====
+Si la sortie est numérique, la fenêtre se ferme.
-Yad a été écrit par Victor Ananjevsky.
-L'icone Yad a été créé par Bogdan Lisovich.
+Si la sortie est non numérique, la fenêtre reste ouverte.
+<code>
+yad --width="300" --height="300" --text='Boutons standards:\nla sortie sera 0, 1, 70 ou 252'
+yad --width="300" --height="300" --text="Bouton personnalisé:\nLa fenêtre s'est fermée car la sortie est numérique.\n Le bouton ci-dessous ne fermera pas la fenêtre\ncar la sortie n'est pas numérique mais le bouton de fermeture de la fenêtre et la touche d'échappement fermeront la fenêtre car les sorties sont numériques." --button='add:echo "La fenêtre reste ouverte."'
+</code>
+===Décorations===
+Pour personnaliser les boutons vous pouvez:
+Utiliser ceux prédéfinis gtk-stock (ex: gtk-close ou gtk-ok).
+Définir vos propres options sous la forme LABEL[!ICON[!TOOLTIP]] où LABEL est le texte du bouton, ICON est l'icone du bouton et TOOLTIP est le texte qui s'affichera au survol du bouton (Le séparateur par défaut est "!".
+<code>
+yad --width="300" --height="300" --text="Bouton personnalisé avec gtk-add." --button='gtk-add:0"'
+yad --width="300" --height="300" --text="Bouton personnalisé avec LABEL[!ICON[!TOOLTIP]]." --button='Mon bouton!search!Ceci est mon bouton personnalisé:0"'
+</code>
+L’icône peut être définie par son chemin complet ou par une icône système (Dans mon exemple "search".).
+===Fermer la fenêtre et lancer une action===
+Il est possible d'affecter une action à un bouton yad.
+<code>
+yad --form --field "Bouton 1:btn" --field "Bouton 2:btn" --field "Bouton 3:btn" "echo 'bouton n°1 cliqué'" "echo 'bouton n°2 cliqué'" "echo 'bouton n°3 cliqué'"
+</code>
+Dans cet exemple simple, l'appui sur un bouton déclenche l'affichage d'un message simple. Il est possible d'aller un peu plus loin en activant une fonction personnalisée ou un script bash.
+<code>
+function bonjour () { echo "Bonjour ""$USER""."; PidYad=$(pgrep yad); echo "Le pid de Yad est ""$PidYad"; }
+export -f bonjour
+yad --form --field "bonjour:btn" "bash -c bonjour"
+</code>
+Dans cet autre exemple, on crée une fonction toute simple qui affiche le nom de l'utilisateur ainsi que le numéro d'identification du processus affecté à yad. Cette fonction est ensuite appelée par le bouton personnalisé yad.
+Ce numéro pid (process identification digit) peut être utilisé pour fermer la fenêtre yad si le bouton appelle un script. En effet, comme indiqué ci-dessus, si la sortie du bouton n'est pas numérique, l'appui sur le bouton ne permet pas de fermer la fenêtre. Avec cette astuce, il est possible de combiner les deux actions. Exemple :
+<code>
+function ferme_yad () { bonjour ; PidYad=$(pgrep yad); kill -s SIGUSR1 "$PidYad";}
+export -f ferme_yad
+yad --form --field "bonjour:btn" "bash -c ferme_yad"
+</code>
+====Récupérer les sorties dans les boîtes multiples.====
+Dans les boîtes multiples la sortie standard sera de type champ1|champ2|champ3| où "|" est le séparateur par défaut.
+Pour récupérer les champs il est donc pratique d'utiliser awk et les variables.
+<code>
+#Envoi de la sortie dans une variable.
+champs=$(yad --title="Mon titre" --text="Mon texte." --text-align="center" \
+--form \
+--field="champ 1:" '' \
+--field="champ 2:" '' \
+--field="champ 3:" '')
+echo "$champs"
+#Récupération des champs avec awk.
+champ1=$(echo $champs | awk 'BEGIN {FS="|" } { print $1 }')
+champ2=$(echo $champs | awk 'BEGIN {FS="|" } { print $2 }')
+champ3=$(echo $champs | awk 'BEGIN {FS="|" } { print $3 }')
+#Affichage des champs.
+echo "$champ1"
+echo "$champ2"
+echo "$champ3"
+</code>
+Une autre méthode consiste à éclater l'ensemble des valeurs dans un tableau en modifiant **temporairement** la valeur de la variable interne bash $IFS qui détermine le séparateur par défaut (en général l'espace).
+<code>
+usr@pc:~$ ANC_IFS="$IFS"; IFS='|' read -ra LesParametres <<< "$retour" ; IFS="$ANC_IFS"
+usr@pc:~$ echo "Champs 1 : ""${LesParametres[0]}"
+usr@pc:~$ echo "Champs 2 : ""${LesParametres[1]}"
+usr@pc:~$ echo "Champs 3 : ""${LesParametres[2]}"
+</code>
+Explications :
+  * ANC_IFS="$IFS" : stockage de la valeur initiale de $IFS dans une nouvelle variable $ANC_IFS
+  * IFS='|' : la valeur de $IFS est fixée à |, le caractère de séparation des champs à la sortie de yad
+  * read -ra LesParametres <<< "$retour"  : affecte l'ensemble des champs dans le tableau $LesParametres. La valeur du premier champ de $retour est insérée dans la case d'indice 0 de $LesParametres, celle du deuxième champ dans la case d'indice 1 et ainsi de suite
+  * IFS="$ANC_IFS" : la valeur initiale de $IFS est rétablie
+  * Pour accéder à la valeur de chaque champ, il suffit d'accéder à la case d'indice correspondant dans le tableau $LesParametres qui est affichée par ${LesParametres[i]} ou i est l'indice de la case.
+==== Gestion d'erreur : Gtk-Message ====
+L'utilisation de fenêtres gtk génère l'affichage d'un message d'erreur dans la console.
+<code>
+usr@pc:~/Rep$ Gtk-Message: GtkDialog mapped without a transient parent. This is discouraged.
+</code>
+Ce message est bien connu et ne correspond pas à une erreur grave. Pour s'en débarrasser, il est conseillé de rediriger les erreurs vers /dev/null.
+<code>
+usr@pc:~/Rep$  yad --title "Exemple simple"  2>/dev/null
+</code>
+===== Désinstallation =====
+Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
+===== Voir aussi =====
+  * **(en)** [[http://manpages.ubuntu.com/manpages/wily/man1/yad.1.html|Manuel des fonctions]]
+  * **(en)** [[http://smokey01.com/yad/|Exemples simples de toutes les fonctions de base (Recommandé)]]
+  * **(en)** [[https://sourceforge.net/p/yad-dialog/wiki/browse_pages/|Site officiel avec exemples d'applications]]
+  * **(en)** [[https://groups.google.com/forum/#!forum/yad-common|Forum de discussion. L'auteur participe.]]
+  * **(en)** [[http://www.thelinuxrain.com/articles/the-buttons-of-yad|Exemples sur les boutons]]
+  * **(en)** [[http://www.thelinuxrain.com/articles/multiple-item-data-entry-with-yad|Exemples sur les items multiples]]
+  * **(en)** [[https://pypi.python.org/pypi?name=yad&version=0.9.3&:action=display|Ajouter Yad à vos scripts Python (non testé)]]
-===== Liens =====
+----
-[[:accueil|interne]]
+//Contributeurs principaux : [[sergeG75018]], LukePerp., [[utilisateurs:amiralgaby]]//
-[[http://doc.ubuntu-fr.org/|externe]]
-[[wp>interwiki]]
+//Basé sur [[http://manpages.ubuntu.com/manpages/wily/man1/yad.1.html|« les pages du manuel »]].//