✎ zenity [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

{{  https://www.chicoree.fr/w/images/0/08/Zenity_info.png?200}}
====== Zenity ======

//Traduction de la courte description sur le site officiel de Zenity.//((Zenity is a tool that allows you to display Gtk+ dialog boxes from the command line and through shell scripts. It is similar to gdialog, but is intended to be saner. It comes from the same family as dialog, Xdialog, and cdialog, but it surpasses those projects by having a cooler name.))

**Zenity** est un outil qui permet d'afficher des boîtes de dialogue GTK+ depuis la ligne de commandes ou au travers de scripts shell. Il est similaire à //gdialog//, mais son but est d'être plus simple. Il appartient à la même famille que //dialog// (affichage de pseudo boîtes de dialogue en console), //xdialog// et //cdialog//.
===== Installation =====

Zenity est installé sur Ubuntu par défaut. Sinon, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>zenity]]**.

===== Utilisation =====
Zenity permet d'afficher 14 types de fenêtre :

Pour plus d'infos, consulter la [[https://help.gnome.org/users/zenity/|(choisir sa version) >> page de manuel de Zenity. ]]

<note tip>__''Note de construction du tableau ci-dessus''__ : \\ Afin d'insérer un saut de ligne dans une même cellule, il suffit d'utiliser la balise ''<espace>\\<espace>'' pour insérer un retour chariot dans une cellule.

__''Note sur Zenity''__ : \\ Il existe un script qui facilite la création de fenêtres Zenity de façon rapide et simple.

Voir le logiciel [[zenitor 3]]. FIXME Cf le chapitre Documentation sur l'obsolescence de Zenitor 3. Problème Python concernant les sources de zenitor 3. Le script est disponible à la page [[https://kiwix.jackbot.fr/ubuntudoc_fr_all_2015-12/A/zenitor_3.html|« Zenitor 3 ou Zenity Generator 3 »]]</note>

==== Exemples =====

Voici quelques infos bonus que certaines personnes ont trouvées.
Car comme vous pouvez le constater, les infos sur Zenity ne sont pas légion...

Ces fonctions ne semblent pas fonctionner pour les fenêtres "entry".

Zenity est basé sur GTK+, lui-même basé sur [[http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html|Pango]], il est donc possible d'utiliser certaines fonctions de ce logiciel.

<note tip> Un module perl permet aussi d'utiliser facilement Zenity au sein des scripts perl, voir [[http://search.cpan.org/~kck/UI-Dialog-1.08/lib/UI/Dialog/Backend/Zenity.pod|la page CPAN associée (en anglais)]]. </note>

=== Coloration du texte ===

Rien de mieux qu'un peu de couleur pour égayer un texte. Pour cela, il faut utiliser la balise "span color" :
<code perl>
red
</code>

Fenêtre de test :
<file perl>zenity --info --text "
red
green
blue
yellow
magenta
white
black
gray
lightblue
lightgray"</file>

=== Choix de la police pour le texte ===

Marre de voir toujours la même police ? Il vous suffit donc d'utiliser la balise "span font-family".

<file perl>
essai de polices
</file>

Fenêtre de test :
<file perl>
zenity --info --text "
essai de polices
essai de polices
essai de polices
essai de polices
essai de polices
essai de polices"
</file>

=== Changer la forme de la police ===

Un mot a besoin de ressortir du reste ? Il suffit de mettre en gras, en italique...

<file perl>
zenity --info --text "
gras
<big>grand</big>
italique
<s>barré</s>
indice
exposant
petit
<tt>espace entre les lettres</tt>
souligné"
</file>

=== Fenêtre avec liste de choix ===
{{ zenity-entry.png}}

Il est possible de créer une fenêtre comme suit :

Pour cela, il faut créer une boite de type "entry" et ajouter les différents choix de la liste à la fin de la commande.

N'oubliez pas les guillemets si vous mettez des espaces dans les réponses.
Ex :
<file bash>
zenity --entry --title="Jour"
--text="Veuillez indiquer le jour de la semaine"
Lundi Mardi Mercredi "Autre jour..."
</file>

Pour ajouter une réponse de base, utilisez l'option "entry-text" :
<file bash>
zenity --entry --title="Jour" \
--text="Veuillez indiquer le jour de la semaine" --entry-text="Lundi" Mardi Mercredi
</file>

=== Boîte de message et récupérer la valeur ===
<file bash>
 if ret=`zenity --entry --title='Titre de la vidéo' \ 
 --text='Saisissez le titre de la vidéo : '`
	then
	 titre=$ret
	 if [ "$titre" = "" ]
	 then
		echo "Il faut un titre, tient pan t'es mort!"
		exit
	 fi
	else
	 echo "Tsss, un titre on dit, pas le bouton annuler!"
	exit
 fi
echo $titre
</file>

=== Méthode 2 pour récupérer la valeur ===

Voici une méthode alternative à celle décrite ci-dessus :
<file bash>
dossierSortie=$(zenity --file-selection \
--title="Veuillez selectionner un dossier" \
--text="Choissisez un dossier quelconque" \
--directory);

echo ${dossierSortie}
sleep 10
</file>

=== Méthode 3 pour récupérer la valeur ===
Très simple :
<file bash>
variable=$(zenity --entry --title="Choix" --text="Indiquez un mot")

echo "le mot choisi est "$variable
sleep 5
</file>

=== Méthode pour récupérer la valeur avec --question ===
<file bash>
zenity --question \
--title "coffee" \
--text "Faire du café ?"

if [ $? = 0 ]
then
	echo "OUI ! Avec 2 sucres ..."
	sleep 3
else
	echo "NON ! Plutôt du thé ..."
	sleep 3
fi
</file>

=== Barres de progression ===

//Depuis [[https://help.gnome.org/users/zenity/stable/progress.html.fr]]//

^ Commande                    ^ Rôle                                                      ^
| %%--text=text%%             | Spécifier le texte affiché dans la boîte de dialogue de barre de progression. |
| %%--percentage=percentage%% | Spécifier le pourcentage initial réglé dans la boîte de dialogue de barre de progression. |
| %%--auto-close%%            | Fermer la boîte de dialogue quand la barre de progression atteint 100%. |
| %%--pulsate%%               | Utiliser une barre de progression discontinue jusqu'à ce qu'un caractère EOF soit lu sur l'entrée standard. |

* Si une ligne commence par '#', le texte est mis à jour avec le texte de cette ligne.
  * Si une ligne contient seulement un nombre, le pourcentage est mis à jour avec ce nombre.
  * %%--progress%% s'utilise avec un [[pipe]]. Vous devez donc mettre tout le code affecté par la barre de progression entre parenthèses.

Exemple :
<file bash>
#!/bin/sh
(
echo "10" ; sleep 1
echo "# Mise à jour des journaux de mail" ; sleep 1
echo "20" ; sleep 1
echo "# Remise à zéro des paramètres" ; sleep 1
echo "50" ; sleep 1
echo "Cette ligne est ignorée" ; sleep 1
echo "75" ; sleep 1
echo "# Redémarrage du système" ; sleep 1
echo "100" ; sleep 1
) |
zenity --progress \
 --title="Mise à jour des journaux système" \
 --text="Analyse des journaux de mail..." \
 --percentage=0

if [ "$?" = -1 ] ; then
 zenity --error \
 --text="Mise à jour annulée."
fi
</file>

{{ http://library.gnome.org/users/zenity/stable/figures/zenity-progress-screenshot.png }}

//Voir aussi une utilisation concrète dans un script nautilus sur la documentation de [[shred#integrer_shred_a_nautilus_script|shred]]//
=== Formulaire ===

<note important>Cette fonction est disponible depuis la version 3.2.0 de Zenity : cela ne fonctionnera pas avec les versions antérieures.</note>

^ Commande                    ^ Rôle                                                      ^
| %%--text=Texte%%             | Spécifier le texte affiché dans la boîte de dialogue de barre de progression. |
| %%--separator=SÉPARATEUR%%                 | Définit le caractère séparateur de sortie. |
| %%--add-entry=Nom du champ%%               | Ajoute une nouvelle zone de saisie dans la boîte de dialogue de formulaire. |
| %%--add-password=Nom du champ%%            | Ajoute une nouvelle zone de saisie de mot de passe dans la boîte de dialogue \\ de formulaire. |
| %%--add-calendar=Nom du champ calendrier%%   | Ajoute un nouveau calendrier dans la boîte de dialogue de formulaire. |
| %%--forms-date-format=MODÈLE%%               | Définit le format de la date retournée. |

__Exemple:__
<file bash>
#!/bin/bash

#On crée le formulaire en stockant les valeurs de sortie dans $cfgpass :/
cfgpass=`zenity --forms \
    --title="Exemple qui tue la mort" \
    --text="Définir un nouveau mot de passe" \
    --add-entry="Nom de l'utilisateur" \
    --add-password="Ancien mot de passe" \
    --add-password="Nouveau mot de passe" \
    --add-password="Confirmer le nouveau mot de passe" \
    --separator="|"`

echo "Franchement la classe cette nouvelle fonction Zenity :P"
</file>

{{ :zenity-forms.png?direct& |http://img11.hostingpics.net/pics/246564zenityforms.png}}

===== Documentation de Zenity ======
==== Manuels ====

* [[https://help.gnome.org/users/zenity/|Page officielle de Zenity]]
  * [[https://help.gnome.org/users/zenity/|Choisir sa version  >> Manuel de Zenity]]
  * **(fr)** [[https://wiki.visionduweb.fr/index.php?title=Programmation_GNU_Linux_Zenity|« Programmation GNU Linux Zenity »]] — Manuel en français illustré par des exemples de code

==== Exemples de code : Zenity par l'exemple ====

* **(fr)** [[https://www.chicoree.fr/w/Afficher_des_bo%C3%AEtes_de_dialogue_avec_Zenity|« Afficher des boîtes de dialogue avec Zenity »]] — source : Chicoree.fr
  * **(fr)** [[https://forum.ubuntu-fr.org/viewtopic.php?id=232644%20|« Zenity a du style ! »]] — source : Forum Ubuntu ; sujet : balises HTML fontes et types de fontes dans Zenity
  * [[zenitor_3|Script de génération de fenêtre Zenity]] script compilé jusqu'à Zesty. Ne fonctionne pas pour les versions suivantes d'Ubuntu. Problèmes de dépendances
  * [[https://sourceforge.net/projects/yad-dialog/|Yad: un fork de Zenity]]: un script multitâches de Zenity

----

//Contributeurs principaux : [[utilisateurs:blackbg]], [[utilisateurs:hizoka]]. \\
Contributeurs secondaires : [[utilisateurs:mirage59]], [[utilisateurs:TheCaméléon]], [[utilisateurs:herrleiche|Herrleiche]], CKDevelop, Heuzef, [[utilisateurs:eagle08]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : U G L Q K Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported