Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
utilisateurs:slyfox:tutos:yad [15/11/2015 17:31] Slyfox [Utilisation] |
utilisateurs:slyfox:tutos:yad [21/11/2015 17:58] Slyfox [Entry] |
||
---|---|---|---|
Ligne 18: | Ligne 18: | ||
==== Jessie stable==== | ==== Jessie stable==== | ||
- | Apparemment il n'exsite pas de paquet pour jessie stable. | + | Apparemment il n’existe pas de paquet pour jessie stable. |
Nous allons devoir l'installer par compilation. (la version actuelle est la 0.25.1) | Nous allons devoir l'installer par compilation. (la version actuelle est la 0.25.1) | ||
<code root>apt-get update | <code root>apt-get update | ||
Ligne 30: | Ligne 30: | ||
</code> | </code> | ||
- | ===== Utilisation ===== | ||
- | ==== Boîte de dialogue ==== | + | |
+ | |||
+ | |||
+ | ===== Règles d'utilisation ===== | ||
+ | |||
+ | * Yad s'utilise en ligne de commande via un terminal ou dans un script. | ||
+ | |||
+ | * La ligne de commande doit commencer par yad suivit des options (voir chapitre "Options générales" et "Options spécifiques"). | ||
+ | |||
+ | * L'ordre dans lequel interviennent le ou les options n'ont pas d'importance. \\ Remarque: dans ce wiki nous utiliserons en premier l'option de boîte puis les options générales puis les options spécifiques. ;-) | ||
+ | |||
+ | * Si une option spécifique n'est pas mentionnée c'est la valeur par défaut qui sera automatique appliqué par yad. | ||
+ | |||
+ | * Chaque option doit être précédée par 2 tirets "--". | ||
+ | |||
+ | * Il existe plusieurs méthodes pour écrire une commande Yad. | ||
+ | Soit le tout sur une ligne: | ||
+ | <file bash> | ||
+ | yad --calendar --center --title="Mon calendrier" | ||
+ | </file> | ||
+ | |||
+ | Soit en colonne dans ce cas avant chaque retour à ligne il faut insérer __un espace__ à la fin de l'option suivit par __un antislash__ "\" sauf à la dernier ligne: | ||
+ | <file bash> | ||
+ | yad \ | ||
+ | --calendar \ | ||
+ | --center \ | ||
+ | --title="Mon calendrier" | ||
+ | </file> | ||
+ | |||
+ | Soit un mixte des deux méthodes ci-dessus: | ||
+ | |||
+ | <file bash> | ||
+ | yad --calendar \ | ||
+ | --center --title="Mon calendrier" | ||
+ | </file> | ||
+ | |||
+ | ===== Options boîtes de dialogue ===== | ||
Yad permet d'afficher 13 types de boite de dialogue. | Yad permet d'afficher 13 types de boite de dialogue. | ||
- | ^ Options ^ Descriptions ^ | + | ^ Options ^ Descriptions |
|**%%--calendar%%** | Affiche un calendrier | | |**%%--calendar%%** | Affiche un calendrier | | ||
|**%%--color%%** | Sélection de couleurs | | |**%%--color%%** | Sélection de couleurs | | ||
|**%%--dnd %%** | Boîte drag-and-drop | | |**%%--dnd %%** | Boîte drag-and-drop | | ||
|**%%--entry%%** | Permet la saisie de caractères | | |**%%--entry%%** | Permet la saisie de caractères | | ||
- | |**%%--icons%%** | Boîte d*affichage avec icônes de raccourci | | + | |**%%--icons%%** | Boîte d'affichage avec icônes de raccourci | |
|**%%--file%%** | Sélection de fichiers ou/et dossiers | | |**%%--file%%** | Sélection de fichiers ou/et dossiers | | ||
|**%%--font%%** | Sélection de la police | | |**%%--font%%** | Sélection de la police | | ||
Ligne 49: | Ligne 84: | ||
|**%%--progress%%** | Permet de suivre une progression | | |**%%--progress%%** | Permet de suivre une progression | | ||
|**%%--text-info%%** | Affiche un texte dans une fenêtre | | |**%%--text-info%%** | Affiche un texte dans une fenêtre | | ||
- | |**%%--scale%%** | Choisir une valeur numérique à l*aide d*un curseur | | + | |**%%--scale%%** | Choisir une valeur numérique à l'aide d'un curseur | |
- | ==== Option général ==== | ||
- | A la suite du type de la boite de dialogue, nous pouvons choisir aucune, une ou plusieurs options générales qui peuvent s'appliquer pour tous les types de boîtes des dialogues ci-dessus. | + | ===== Options générales ===== |
- | <note>Si l'option est suivit par = et des lettres en majuscule, il suffit de les remplacer par la valeur que nous voulons lui donner et cela entre 2 guillemets. | + | <note> |
+ | Si l'option est suivit par = et des lettres en majuscule, il suffit de les remplacer par la valeur que nous voulons lui donner et cela entre 2 guillemets. | ||
+ | </note> | ||
- | Voici un exemple avec une boite de dialogue du type calendrier et avec l'option **%%--title=TITLE%%** . \\ | + | ^ Options ^ Descriptions |
- | <code user>yad --calendar --title="Mon calendrier Yad"</code></note> | + | |
- | + | ||
- | ^ Options ^ Descriptions ^ | + | |
|**%%--title=TITLE%%** | Titre de la boîte de dialogue | | |**%%--title=TITLE%%** | Titre de la boîte de dialogue | | ||
|**%%--window-icon=ICONPATH%%** | Chemin de l'icône | | |**%%--window-icon=ICONPATH%%** | Chemin de l'icône | | ||
- | |**%%--width=WIDTH%%** | Hauteur de la boite de dialogue | | + | |**%%--width=WIDTH%%** | Hauteur de la boîte de dialogue | |
- | |**%%--height=HEIGHT%%** | Largeur de la boite de dialogue | | + | |**%%--height=HEIGHT%%** | Largeur de la boîte de dialogue | |
|**%%--timeout=TIMEOUT%%** | Temps d'affichage | | |**%%--timeout=TIMEOUT%%** | Temps d'affichage | | ||
|**%%--timeout-indicator=POSITION%%** | FIXME | | |**%%--timeout-indicator=POSITION%%** | FIXME | | ||
|**%%--kill-parent%%** | Envoie SIGTERM au processus parent | | |**%%--kill-parent%%** | Envoie SIGTERM au processus parent | | ||
- | |**%%--text=STRING%%** | Texte à l'interieur de la boite de dialogue | | + | |**%%--text=STRING%%** | Texte à l’intérieur de la boîte de dialogue | |
- | |**%%--image=IMAGE%%** | Image qui apparaît sur le côté gauche de la boîte de dialogue. \\ IMAGE peut être un nom de fichier ou le nom de l'icône du thème d*icônes courant.| | + | |**%%--image=IMAGE%%** | Image qui apparaît sur le côté gauche de la boîte de dialogue. \\ IMAGE peut être un nom de fichier ou le nom de l'icône du thème d'icônes courant.| |
|**%%--image-on-top%%** | Place l'image au-dessus, doit-être utilisé avec l'option %%--image%% | | |**%%--image-on-top%%** | Place l'image au-dessus, doit-être utilisé avec l'option %%--image%% | | ||
|**%%--icon-theme = THEME%%** | Utilise une icône du thème GTK au lieu de celle utilisé par défaut | | |**%%--icon-theme = THEME%%** | Utilise une icône du thème GTK au lieu de celle utilisé par défaut | | ||
Ligne 79: | Ligne 112: | ||
|**%%--always-print-result%%** | Imprime toujours le résultat | | |**%%--always-print-result%%** | Imprime toujours le résultat | | ||
|**%%--dialog-sep%%** | FIXME | | |**%%--dialog-sep%%** | FIXME | | ||
- | |**%%--borders=NUM%%** | Définit les bordures de la boite de dialogue | | + | |**%%--borders=NUM%%** | Définit les bordures de la boîte de dialogue | |
- | |**%%--sticky%%** | Affiche de la boite de dialogue sur tous les bureaux | | + | |**%%--sticky%%** | Affiche la boîte de dialogue sur tous les bureaux | |
- | |**%%--fixed%%** | Verrouille la hauteur et la largeur de la boite de dialogue | | + | |**%%--fixed%%** | Verrouille la hauteur et la largeur de la boîte de dialogue | |
- | |**%%--center%%** | Place la boite de dialogue à son ouverture au centre de l*écran | | + | |**%%--center%%** | Place la boîte de dialogue à son ouverture au centre de l'écran | |
- | |**%%--mouse%%** | Place la boite dialogue à son ouverture sous la position de la souris | | + | |**%%--mouse%%** | Place la boîte dialogue à son ouverture sous la position de la souris | |
- | |**%%--on-top%%** | Place la boite dialogue à son ouverture par dessus les autre fenêtre. | | + | |**%%--on-top%%** | Place la boîte dialogue à son ouverture par-dessus les autre fenêtre. | |
- | |**%%--skip-taskbar%%** | N'affiche pas la boite de dialogue dans la barre de tache ou le pager | | + | |**%%--skip-taskbar%%** | N'affiche pas la boîte de dialogue dans la barre de tâche ou le pager | |
|**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | |**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | ||
|**%%--selectable-labels%%** | FIXME | | |**%%--selectable-labels%%** | FIXME | | ||
- | ==== Options du calendrier ==== | + | ===== Options spécifiques ===== |
- | ^ Options ^ Descriptions ^ | + | ==== Calendrier ==== |
+ | |||
+ | ^ Options ^ Descriptions | ||
|**%%--day=INT%%** | Jour par défaut | | |**%%--day=INT%%** | Jour par défaut | | ||
|**%%--month=INT%%** | Mois par défaut | | |**%%--month=INT%%** | Mois par défaut | | ||
|**%%--year=INT%%** | Année par défaut | | |**%%--year=INT%%** | Année par défaut | | ||
- | |**%%--date-format=MOTIF%%** | Régler le format de la date de retour. Par défaut c'est `% x ' | | + | |**%%--date-format=MOTIF%%** | Régler le format de retour la date. Par défaut c'est `% x ' \\ Pour plus info sur les format de date faire man date| |
|**%%--details = FILENAME%%** | FIXME | | |**%%--details = FILENAME%%** | FIXME | | ||
|**%%--init-color=COULEUR%%** | Définit une valeur initiale de la couleur. | | |**%%--init-color=COULEUR%%** | Définit une valeur initiale de la couleur. | | ||
Ligne 105: | Ligne 140: | ||
=== Exemple === | === Exemple === | ||
- | Ici nous allons créé une boite de dialogue de type calendrier avec comme titre "Mon calendrier Yad", date par défaut le 30 janvier 2000 et comme format de retour Année-Mois-Jour. | + | Ci-dessous une boite de dialogue de type calendrier, avec une largeur de 250 et une hauteur de 200, comme titre "Calendrier Yad", date par défaut le 30 janvier 2000 et comme format de retour Année-Mois-Jour. |
+ | |||
+ | <file bash> | ||
+ | yad \ | ||
+ | --calendar \ | ||
+ | --width=250 \ | ||
+ | --height=200 \ | ||
+ | --title="Calendrier Yad" \ | ||
+ | --day="30" --month="1" --year="2000" \ | ||
+ | --date-format="%Y-%m-%d" | ||
+ | </file> | ||
+ | |||
+ | {{/file-R272fce0547b743152a543eb046f5aaef.png}} | ||
+ | |||
+ | ==== Drag-and-Drop ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--tooltip%%** | Utiliser un texte de dialogue comme une bulle d'aide. | | ||
+ | |**%%--command=CMD%%** | Lancer la commande lorsque les données sont reçues. Les chaînes de données passent comme la commande d'un argument. \\ Par défaut les données sont imprimé sur la sortie standard. | | ||
+ | |||
+ | |||
+ | === Exemple === | ||
+ | Ci-dessous une boite de dialogue de type Drag-and-Drop, avec une largeur de 400 et une hauteur de 100 avec comme titre "Drag & Drop Yad / Mplayer" qui nous permet de lancer une vidéo juste en glissant la vidéo sur la fenêtre. (Il faut au préalable avoir installer Mplayer). \\ | ||
+ | Si on passe avec le curseur sur la boite de dialogue l'info-bulle s'affiche. | ||
+ | |||
+ | <file bash> | ||
+ | yad \ | ||
+ | --dnd \ | ||
+ | --width=400 \ | ||
+ | --height=100 \ | ||
+ | --title "Drag & Drop Yad / Mplayer" \ | ||
+ | --text "Glisser ici le fichier vidéo à lire" \ | ||
+ | --image "insert-object" \ | ||
+ | --command=mplayer \ | ||
+ | --tooltip | ||
+ | </file> | ||
+ | |||
+ | {{/file-R8d6aaf1191e3a1dd0ad35e38247bb657.png}} | ||
+ | |||
+ | ===== Entry ===== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--entry-label=STRING%%** |Texte devant l'étiquette d'entrée. (équivalant à read en bash)| | ||
+ | |**%%--entry-text=STRING%%** |Text de défaut de l'étiquette| | ||
+ | |**%%--hide-text%%** |Cache le texte d'entrée. | | ||
+ | |**%%--completion%%** |Utilise l'achèvement lieu de combo-box. | | ||
+ | |**%%--editable%%** |Autorisation d'apporter des modifications au texte dans la liste déroulante. | | ||
+ | |**%%--numeric%%** |FIXME | | ||
+ | |**%%--licon=IMAGE%%** |Icône sur le côté gauche de l'entrée. | | ||
+ | |**%%--licon-action=CMD%%** |Commande qui sera exécuté lors d'un clique sur l'icône de gauche. La commande de sortie sera créée sous forme de texte d'entrée. | | ||
+ | |**%%--ricon=IMAGE%%** |Icône sur le côté droite de l'entrée. | | ||
+ | |**%%--ricon-action=CMD%%** |Commande qui sera exécuté lors d'un clique sur l'icône de droite. La commande de sortie sera créée sous forme de texte d'entrée. | | ||
+ | |**%%--num-sortie%%** |FIXME | | ||
+ | |||
+ | |||
+ | |||
+ | <file bash> | ||
+ | yad / | ||
+ | --entry / | ||
+ | --width=400 \ | ||
+ | --height=100 \ | ||
+ | --entry-label="Taper votre nom d'utilisateur" / | ||
+ | --editable / | ||
+ | --entry-text="$USER" " Toto" | ||
+ | </file> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Options boite de dialogue icons ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--read-dir=PATH%%** | FIXME | | ||
+ | |**%%--generic%%** | FIXME | | ||
+ | |**%%--sort-by-name%%** | FIXME | | ||
+ | |**%%--descend%%** | FIXME | | ||
+ | |**%%--listen%%** | FIXME | | ||
+ | |**%%--item-width%%** | FIXME | | ||
+ | |**%%--compact%%** | FIXME | | ||
+ | |**%%--single-click%%** | FIXME | | ||
+ | |**%%--term%%** | FIXME | | ||
+ | |||
+ | ==== Options boite de dialogue file ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue font ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue form ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue list ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue notification ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue progress ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | |||
+ | ==== Options boite de dialogue text-info ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | ==== Options boite de dialogue scale ==== | ||
- | <code user>yad --calendar --title="Mon calendrier Yad" --day="30" --month="1" --year="2000" --date-format="%Y-%m-%d"</code> | + | ^ Options ^ Descriptions |
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
- | {{/file-R75334260dc617d4284ad74a93d59497d.png}} | ||