Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
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 [18/11/2015 21:46] Slyfox [Règles d'utilisation] |
utilisateurs:slyfox:tutos:yad [22/11/2015 15:15] Slyfox [Options générales] |
||
|---|---|---|---|
| Ligne 2: | Ligne 2: | ||
| * Objet : Installtion et utilisation de yad | * Objet : Installtion et utilisation de yad | ||
| - | * Niveau requis : {{tag>avançé}} | + | * Niveau requis : {{tag>intermédiaire}} |
| * Commentaires : //Contexte d'utilisation du sujet du tuto. // FIXME | * Commentaires : //Contexte d'utilisation du sujet du tuto. // FIXME | ||
| * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | ||
| 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> | ||
| + | ===== Règles d'utilisation ===== | ||
| + | * Yad s'utilise en ligne de commande via un terminal ou dans un script. | ||
| - | ===== Options boîtes de dialogue ===== | + | * La ligne de commande doit commencer par yad suivit des options (voir chapitre "Options générales" et "Options spécifiques"). |
| - | Yad permet d'afficher 13 types de boite de dialogue. | + | * L'ordre dans lequel interviennent le ou les options n'ont pas d'importance. |
| - | ^ Options ^ Descriptions | + | * Si une option spécifique n'est pas mentionnée c'est la valeur par défaut qui sera automatique appliqué par yad. |
| - | |**%%--calendar%%** | Affiche un calendrier | | + | |
| - | |**%%--color%%** | Sélection de couleurs | | + | |
| - | |**%%--dnd %%** | Boîte drag-and-drop | | + | |
| - | |**%%--entry%%** | Permet la saisie de caractères | | + | |
| - | |**%%--icons%%** | Boîte d*affichage avec icônes de raccourci | | + | |
| - | |**%%--file%%** | Sélection de fichiers ou/et dossiers | | + | |
| - | |**%%--font%%** | Sélection de la police | | + | |
| - | |**%%--form%%** | Permet la saisie de caractères | | + | |
| - | |**%%--list%%** | Affiche une liste | | + | |
| - | |**%%--notification%%** | Afficher une notification dans la zone prévue à cet effet | | + | |
| - | |**%%--progress%%** | Permet de suivre une progression | | + | |
| - | |**%%--text-info%%** | Affiche un texte dans une fenêtre | | + | |
| - | |**%%--scale%%** | Choisir une valeur numérique à l*aide d*un curseur | | + | |
| - | ===== Règles d'utilisation ===== | + | * Chaque option doit être précédée par 2 tirets "--". |
| - | * Yad s'utilise en ligne de commande via un terminal ou dans un script. | ||
| - | * La lignes 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, dans ce wiki nous utiliserons en premier l'option de type de boite puis les options générales puis les options spécifiques. ;-) | ||
| - | * Si une option spécifique n'est pas mentionné c'est la valeur par défaut qui sera automatique appliqué par yad. | ||
| - | * Chaque option doit être précédé par 2 tirets "--". | ||
| * Il existe plusieurs méthodes pour écrire une commande Yad. | * Il existe plusieurs méthodes pour écrire une commande Yad. | ||
| Soit le tout sur une ligne: | Soit le tout sur une ligne: | ||
| Ligne 79: | Ligne 63: | ||
| </file> | </file> | ||
| + | ===== Options boîtes de dialogue ===== | ||
| + | Yad permet d'afficher 17 types de boite de dialogue. | ||
| + | |||
| + | ^ Options ^ Descriptions | ||
| + | |**%%--calendar%%** | Affiche un calendrier | | ||
| + | |**%%--color%%** | Sélection de couleurs | | ||
| + | |**%%--dnd %%** | Boîte drag-and-drop | | ||
| + | |**%%--entry%%** | Permet la saisie de caractères | | ||
| + | |**%%--icons%%** | Boîte d'affichage avec icônes de raccourci | | ||
| + | |**%%--file%%** | Sélection de fichiers ou/et dossiers | | ||
| + | |**%%--font%%** | Sélection de la police | | ||
| + | |**%%--form%%** | Formulaire | | ||
| + | |**%%--html%%** | Affiche une boite de dialogue HTLM | | ||
| + | |**%%--list%%** | Affiche une liste | | ||
| + | |**%%--multi-progress%%** | Affiche plusieurs barres de progressions | | ||
| + | |**%%--notebook%%** | FIXME | | ||
| + | |**%%--notification%%** | FIXME | | ||
| + | |**%%--print%%** | FIXME | | ||
| + | |**%%--progress%%** | Permet de suivre une progression | | ||
| + | |**%%--text-info%%** | Affiche un texte d'information | | ||
| + | |**%%--scale%%** | Choisir une valeur numérique à l'aide d'un curseur | | ||
| Ligne 92: | Ligne 97: | ||
| |**%%--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 | | + | |**%%--parent-win=XID%%** | FIXME | |
| - | |**%%--text=STRING%%** | Texte à l'interieur de la boite de dialogue | | + | |**%%--kill-parent[=SIGNAL]%%** | Envoie SIGTERM au processus parent | |
| - | |**%%--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.| | + | |**%%--plug=KEY%%** | FIXME | |
| + | |**%%--tabnum=NUMBER%%** | FIXME | | ||
| + | |**%%--text=STRING%%** | Texte à l’intérieur de la boîte de dialogue | | ||
| + | |**%%--text-align=TYPE%%** | FIXME | | ||
| + | |**%%--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 104: | Ligne 113: | ||
| |**%%--button=BUTTON:ID%%** | Rajoute en bouton, ID correspond au code de sortie | | |**%%--button=BUTTON:ID%%** | Rajoute en bouton, ID correspond au code de sortie | | ||
| |**%%--no-buttons%%** | Affiche aucun bouton | | |**%%--no-buttons%%** | Affiche aucun bouton | | ||
| + | |**%%--buttons-layout=TYPE%%** | FIXME | | ||
| |**%%--no-markup%%** | FIXME | | |**%%--no-markup%%** | FIXME | | ||
| + | |**%%--no-escape%%** | FIXME | | ||
| |**%%--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 | | + | |**%%--undecorated%%** | FIXME | |
| + | |**%%--skip-taskbar%%** | FIXME | | ||
| + | |**%%--maximized%%** | FIXME | | ||
| + | |**%%--fullscreen%%** | FIXME | | ||
| + | |**%%--splash%%** | FIXME | | ||
| + | |**%%--no-focus%%** | FIXME | | ||
| |**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | |**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | ||
| |**%%--selectable-labels%%** | FIXME | | |**%%--selectable-labels%%** | FIXME | | ||
| + | |**%%--image-path=PATH%%** | FIXME | | ||
| + | |**%%--rest=FILENAME%%** | FIXME | | ||
| + | |**%%--gtkrc=FILENAME%%** | FIXME | | ||
| + | |||
| ===== Options spécifiques ===== | ===== Options spécifiques ===== | ||
| - | ==== Calendrier ==== | + | ==== --calendar ==== |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 135: | Ligne 155: | ||
| === Exemple === | === Exemple === | ||
| - | Ici nous allons créé une boite de dialogue de type calendrier avec comme titre "Calendrier", 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> | <file bash> | ||
| yad \ | yad \ | ||
| --calendar \ | --calendar \ | ||
| - | --title="Calendrier" \ | + | --width=250 \ |
| + | --height=200 \ | ||
| + | --title="Calendrier Yad" \ | ||
| --day="30" --month="1" --year="2000" \ | --day="30" --month="1" --year="2000" \ | ||
| --date-format="%Y-%m-%d" | --date-format="%Y-%m-%d" | ||
| </file> | </file> | ||
| - | {{/file-R75334260dc617d4284ad74a93d59497d.png}} | + | {{/file-R272fce0547b743152a543eb046f5aaef.png}} |
| - | ==== Drag-and-Drop ==== | + | |
| + | ==== --color ==== | ||
| + | |||
| + | ^ Options ^ Descriptions | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |**%%--xxxx%%** | FIXME | | ||
| + | |||
| + | ==== --dnd ==== | ||
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| - | |**%%--tooltip%%** | Utilisez un texte de dialogue comme une bulle d'aide. | | + | |**%%--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. | | |**%%--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 === | === 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). \\ | |
| - | Ici nous allons créer une boite de dialogue de type Drag-and-Drop qui peut nous permettre 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 l'image de la fenêtre une info-bulle s'affichera. | + | Si on passe avec le curseur sur la boite de dialogue l'info-bulle s'affiche. |
| <file bash> | <file bash> | ||
| yad \ | yad \ | ||
| --dnd \ | --dnd \ | ||
| - | --title "Drag & Drop" \ | + | --width=400 \ |
| + | --height=100 \ | ||
| + | --title "Drag & Drop Yad / Mplayer" \ | ||
| --text "Glisser ici le fichier vidéo à lire" \ | --text "Glisser ici le fichier vidéo à lire" \ | ||
| --image "insert-object" \ | --image "insert-object" \ | ||
| Ligne 168: | Ligne 206: | ||
| </file> | </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 | | ||
| - | ==== Options boite de dialogue entry ==== | + | === Exemple === |
| + | |||
| + | Ci-dessous une boite de dialogue de type entry, avec comme titre "Qui est-ce ?". Cette boite nous demande de taper le nom de l'utilisateur, nous pouvons soit taper le nom de l'utilisateur ou choisir un nom dans la liste déroulante. | ||
| + | |||
| + | <file bash> | ||
| + | yad \ | ||
| + | --entry \ | ||
| + | --title="Qui est-ce ?" \ | ||
| + | --entry-label="Taper votre nom d'utilisateur" \ | ||
| + | --editable \ | ||
| + | --entry-text="$USER" "Toto" | ||
| + | </file> | ||
| + | |||
| + | {{/file-Rb6d41888842b6b0356d67fc36125a3c2.png}} | ||
| + | |||
| + | ==== --icons ==== | ||
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--read-dir=PATH%%** | Liste les fichiers de type .desktop du répertoire spécifié. | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--generic%%** | Utilise le nom générique du raccourci.| |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--sort-by-name%%** | Trie les icônes par ordre alphabétique | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--descend%%** | Trie les éléments dans l'ordre décroissant. Si les données sont STDIN cette option est inutile sans --sort-by-name. | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--listen%%** | FIXME | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--item-width%%** | Régler la largeur. | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--compact%%** | Utilise le mode compact.| |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--single-click%%** | Active les éléments par simple clic de souris. Cette option ne peut fonctionne correctement en cas de mode compact. | |
| - | |**%%--xxxx%%** | FIXME | | + | |**%%--term%%** | FIXME | |
| - | ==== Options boite de dialogue icons ==== | + | |
| + | === Exemple === | ||
| + | |||
| + | Ci-dessous une boite de dialogue de type icons, avec une largeur de 1000 et une hauteur de 900, comme titre "Mon menu", qui nous permet de lancer une application par un simple double-clic. | ||
| + | |||
| + | <file bash> | ||
| + | yad \ | ||
| + | --icons \ | ||
| + | --title="Mon menu" \ | ||
| + | --width=1000 \ | ||
| + | --height=900 \ | ||
| + | --read-dir=/usr/share/applications yad \ | ||
| + | --sort-by-name | ||
| + | </file> | ||
| + | |||
| + | {{/file-Rdbb917fe94e16326ffcb13fc1fcf823c.png?500}} | ||
| + | |||
| + | ==== --file ==== | ||
| + | |||
| + | ^ Options ^ Descriptions | ||
| + | |**%%--filename=FILENAME%%** | FIXME | | ||
| + | |**%%--multiple%%** | FIXME | | ||
| + | |**%%--directory%%** | FIXME | | ||
| + | |**%%--save%%** | FIXME | | ||
| + | |**%%--separator=STRING%%** | FIXME | | ||
| + | |**%%--confirm-overwrite[=TEXT]%%** | FIXME | | ||
| + | |**%%--quoted-output%%** | FIXME | | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ==== --font ==== | ||
| + | |||
| + | ^ Options ^ Descriptions | ||
| + | |**%%--https://www.mankier.com/1/yad#--fontname%%** | FIXME | | ||
| + | |**%%--preview%%** | FIXME | | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ==== --form ==== | ||
| + | |||
| + | ^ Options ^ Descriptions | ||
| + | |**%%--field=LABEL[:TYPE]%%** | FIXME | | ||
| + | |**%%--align=TYPE%%** | FIXME | | ||
| + | |**%%--columns=NUMBER%%** | FIXME | | ||
| + | |**%%--separator=STRING%%** | FIXME | | ||
| + | |**%%--item-separator=STRING%%** | FIXME | | ||
| + | |**%%--date-format=PATTERN%%** | FIXME | | ||
| + | |**%%--scroll%%** | FIXME | | ||
| + | |**%%--quoted-output%%** | FIXME | | ||
| + | |**%%--output-by-row%%** | FIXME | | ||
| + | |**%%--num-output%%** | FIXME | | ||
| + | |||
| + | ==== --html ==== | ||
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 197: | Ligne 319: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | ==== Options boite de dialogue file ==== | + | |
| + | ==== --list ==== | ||
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 211: | Ligne 334: | ||
| - | ==== Options boite de dialogue font ==== | + | ==== --multi-progress ==== |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 225: | Ligne 348: | ||
| - | ==== Options boite de dialogue form ==== | + | ==== --notebook ==== |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 238: | Ligne 361: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | + | ==== --notification ==== | |
| - | ==== Options boite de dialogue list ==== | + | |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 252: | Ligne 374: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | + | ==== --print ==== | |
| - | ==== Options boite de dialogue notification ==== | + | |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 266: | Ligne 387: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | + | ==== --progress ==== | |
| - | ==== Options boite de dialogue progress ==== | + | |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 280: | Ligne 400: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | + | ==== --text-info ==== | |
| - | ==== Options boite de dialogue text-info ==== | + | |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 294: | Ligne 413: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | ==== Options boite de dialogue scale ==== | + | ==== --scale ==== |
| ^ Options ^ Descriptions | ^ Options ^ Descriptions | ||
| Ligne 306: | Ligne 425: | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| |**%%--xxxx%%** | FIXME | | |**%%--xxxx%%** | FIXME | | ||
| - | |||
