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 09:29] Slyfox [Utilisation] |
utilisateurs:slyfox:tutos:yad [18/11/2015 21:58] 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. |
- | Yad permet d'afficher 13 types de boîte de dialogue- | + | * La lignes de commande doit commencer par yad suivit des options (voir chapitre "Options générales" et "Options spécifiques"). |
- | ^ Argument ^ Description ^ | + | * 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. ;-) |
- | |''%%--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 | | + | |
+ | * Si une option spécifique n'est pas mentionné c'est la valeur par défaut qui sera automatique appliqué par yad. | ||
- | ==== Option général ==== | + | * Chaque option doit être précédé par 2 tirets "--". |
- | 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. | + | * 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> | ||
- | <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. | + | 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> | ||
- | Voici un exemple avec une boite de dialogue du type calendrier et avec l'option ''%%--title=TITLE%%'' . \\ | + | Soit un mixte des deux méthodes ci-dessus: |
- | <code user>yad --calendar --title="Mon calendrier Yad"</code></note> | + | |
- | ^ option ^ Description ^ | + | <file bash> |
- | |''%%--title=TITLE%%'' | Définir le titre de la boîte de dialogue | | + | yad --calendar \ |
- | |''%%--window-icon=ICONPATH%%'' | Sélection de couleurs | | + | --center --title="Mon calendrier" |
- | |''%%--width=WIDTH%%'' | Boîte drag-and-drop | | + | </file> |
- | |''%%--height=HEIGHT%%'' | Permet la saisie de caractères | | + | ===== Options boîtes de dialogue ===== |
- | |''%%--timeout=TIMEOUT%%'' | Boîte d'affichage avec icônes de raccourci | | + | |
- | |''%%--timeout-indicator=POSITION%%'' | Sélection de fichiers ou/et dossiers | | + | |
- | |''%%--kill-parent%%'' | Sélection de la police | | + | Yad permet d'afficher 13 types de boite de dialogue. |
- | |''%%--text=STRING%%'' | Permet la saisie de caractères | | + | |
- | |''%%--image=IMAGE%%'' | Affiche une liste | | + | |
- | |''%%--expander=TEXT%%'' | Afficher une notification dans la zone prévue à cet effet | | + | ^ Options ^ Descriptions |
- | |''%%--icon-theme=THEME%%'' | Permet de suivre une progression | | + | |**%%--calendar%%** | Affiche un calendrier | |
- | |''%%--button=BUTTON:ID%%'' | Affiche un texte dans une fenêtre | | + | |**%%--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 | | ||
- | |''%%--no-buttons%%'' | Choisir une valeur numérique à l'aide d'un curseur | | ||
- | |''%%--no-markup%%'' | Affiche un calendrier | | ||
- | |''%%--always-print-result%%'' | Sélection de couleurs | | ||
- | |''%%--dialog-sep%%'' | Boîte drag-and-drop | | ||
- | |''%%--borders=NUM%%'' | Permet la saisie de caractères | | ||
- | |''%%--sticky%%'' | Boîte d'affichage avec icônes de raccourci | | ||
- | |''%%--fixed%%'' | Sélection de fichiers ou/et dossiers | | + | ===== Options générales ===== |
- | |''%%--center%%'' | Sélection de la police | | + | |
- | |''%%--mouse%%'' | Permet la saisie de caractères | | + | |
- | |''%%--on-top%%'' | Affiche une liste | | + | <note> |
- | |''%%--skip-taskbar%%'' | Afficher une notification dans la zone prévue à cet effet | | + | 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. |
- | |''%%--geometry=WIDTHxHEIGHT+X+Y%%'' | Permet de suivre une progression | | + | </note> |
- | |''%%--selectable-labels%%'' | Affiche un texte dans une fenêtre | | + | |
+ | ^ 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 comme titre "Calendrier", date par défaut le 30 janvier 2000 et comme format de retour Année-Mois-Jour. | ||
+ | <file bash> | ||
+ | yad \ | ||
+ | --calendar \ | ||
+ | --title="Calendrier" \ | ||
+ | --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 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" \ | ||
+ | --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 | | ||
+ | |||
+ | ==== 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 ==== | ||
+ | |||
+ | ^ Options ^ Descriptions | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||
+ | |**%%--xxxx%%** | FIXME | | ||