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 10:30] Slyfox [Utilisation] |
utilisateurs:slyfox:tutos:yad [18/11/2015 22:05] Slyfox [Options spécifiques] |
||
---|---|---|---|
Ligne 34: | Ligne 34: | ||
- | ===== Utilisation ===== | + | ===== Règles d'utilisation ===== |
- | ==== Boîte de dialogue ==== | + | * 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. \\ Remarque: dans ce wiki nous utiliserons en premier l'option 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. | ||
+ | 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. | ||
- | ^ Argument ^ Description ^ | + | ^ 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 | |
- | |''%%--form%%'' | Permet la saisie de caractères | | + | |**%%--form%%** | Permet la saisie de caractères | |
- | |''%%--list%%'' | Affiche une liste | | + | |**%%--list%%** | Affiche une liste | |
- | |''%%--notification%%'' | Afficher une notification dans la zone prévue à cet effet | | + | |**%%--notification%%** | Afficher une notification dans la zone prévue à cet effet | |
- | |''%%--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 | |
+ | |||
+ | |||
+ | |||
+ | ===== 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> | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--title=TITLE%%** | Titre de la boîte de dialogue | | ||
+ | |**%%--window-icon=ICONPATH%%** | Chemin de l'icône | | ||
+ | |**%%--width=WIDTH%%** | Hauteur de la boite de dialogue | | ||
+ | |**%%--height=HEIGHT%%** | Largeur de la boite de dialogue | | ||
+ | |**%%--timeout=TIMEOUT%%** | Temps d'affichage | | ||
+ | |**%%--timeout-indicator=POSITION%%** | FIXME | | ||
+ | |**%%--kill-parent%%** | Envoie SIGTERM au processus parent | | ||
+ | |**%%--text=STRING%%** | Texte à l'interieur de la boite 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-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 | | ||
+ | |**%%--expander=TEXT%%** | FIXME | | ||
+ | |**%%--button=BUTTON:ID%%** | Rajoute en bouton, ID correspond au code de sortie | | ||
+ | |**%%--no-buttons%%** | Affiche aucun bouton | | ||
+ | |**%%--no-markup%%** | FIXME | | ||
+ | |**%%--always-print-result%%** | Imprime toujours le résultat | | ||
+ | |**%%--dialog-sep%%** | FIXME | | ||
+ | |**%%--borders=NUM%%** | Définit les bordures de la boite de dialogue | | ||
+ | |**%%--sticky%%** | Affiche de la boite de dialogue sur tous les bureaux | | ||
+ | |**%%--fixed%%** | Verrouille la hauteur et la largeur de la boite de dialogue | | ||
+ | |**%%--center%%** | Place la boite de dialogue à son ouverture au centre de l*écran | | ||
+ | |**%%--mouse%%** | Place la boite dialogue à son ouverture sous la position de la souris | | ||
+ | |**%%--on-top%%** | Place la boite 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 | | ||
+ | |**%%--geometry=WIDTHxHEIGHT+X+Y%%** | FIXME | | ||
+ | |**%%--selectable-labels%%** | FIXME | | ||
+ | |||
+ | ===== Options spécifiques ===== | ||
+ | |||
+ | ==== Calendrier ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--day=INT%%** | Jour par défaut | | ||
+ | |**%%--month=INT%%** | Mois par défaut | | ||
+ | |**%%--year=INT%%** | Année par défaut | | ||
+ | |**%%--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 | | ||
+ | |**%%--init-color=COULEUR%%** | Définit une valeur initiale de la couleur. | | ||
+ | |**%%--extra%%** | FIXME | | ||
+ | |**%%--palette[= fichier]%%** | FIXME | | ||
+ | |||
+ | <note>Si aucun jour, mois, année est spécifiés c'est la date actuel qui est utilisé par défaut</note> | ||
+ | |||
+ | === Exemple === | ||
+ | |||
+ | 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-R75334260dc617d4284ad74a93d59497d.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 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 l'image de la boite de dialogue l'info-bulle s'affiche. | ||
+ | |||
+ | <file bash> | ||
+ | yad \ | ||
+ | --dnd \ | ||
+ | --title "Drag & Drop Yad / Mplayer" \ | ||
+ | --text "Glisser ici le fichier vidéo à lire" \ | ||
+ | --image "insert-object" \ | ||
+ | --command=mplayer \ | ||
+ | --tooltip | ||
+ | </file> | ||
+ | |||
+ | {{/file-Raa61272aa2ad050dbe0d42451463b33f.png}} | ||
+ | |||
+ | ==== Options boite de dialogue entry ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |||
+ | ==== Options boite de dialogue icons ==== | ||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
- | ==== Option général ==== | + | ==== Options boite de dialogue file ==== |
- | 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 ^ Descriptions |
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
- | <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. | ||
- | Voici un exemple avec une boite de dialogue du type calendrier et avec l'option ''%%--title=TITLE%%'' . \\ | + | ==== Options boite de dialogue font ==== |
- | <code user>yad --calendar --title="Mon calendrier Yad"</code></note> | + | |
- | ^ option ^ Description ^ | + | ^ Options ^ Descriptions |
- | |''%%--title=TITLE%%'' | Titre de la boîte de dialogue | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--window-icon=ICONPATH%%'' | Chemin de l'icône | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--width=WIDTH%%'' | Hauteur de la boite de dialogue | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--height=HEIGHT%%'' | Largeur de la boite de dialogue | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--timeout=TIMEOUT%%'' | Temps d'affichage | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--timeout-indicator=POSITION%%'' | FIXME | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--kill-parent%%'' | Envoie SIGTERM au processus parent | | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--text=STRING%%'' | Texte à l'interieur de la boite de dialogue | | + | |**%%--xxxx%%** | 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.| | + | |**%%--xxxx%%** | FIXME | |
- | |''%%--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 | | + | |
- | |''%%--expander=TEXT%%'' | FIXME | | + | |
- | |''%%--button=BUTTON:ID%%'' | Rajoute en bouton, ID correspond au code de sortie | | + | |
- | |''%%--no-buttons%%'' | Affiche aucun bouton | | + | |
- | |''%%--no-markup%%'' | FIXME | | + | |
- | |''%%--always-print-result%%'' | Imprime toujours le résultat | | + | |
- | |''%%--dialog-sep%%'' | FIXME | | + | |
- | |''%%--borders=NUM%%'' | Définit les bordures de la boite de dialogue | | + | |
- | |''%%--sticky%%'' | Affiche de la boite de dialogue sur tous les bureaux | | + | |
- | |''%%--fixed%%'' | Verrouille la hauteur et la largeur de la boite de dialogue | | + | |
- | |''%%--center%%'' | Place la boite de dialogue à son ouverture au centre de l'écran | | + | |
- | |''%%--mouse%%'' | Place la boite dialogue à son ouverture sous la position de la souris | | + | |
- | |''%%--on-top%%'' | Place la boite 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 | | + | |
- | |''%%--geometry=WIDTHxHEIGHT+X+Y%%'' | FIXME | | + | |
- | |''%%--selectable-labels%%'' | 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 ==== | ||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||