apropos

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

apropos [2011/08/24 21:36] (Version actuelle)
Ligne 1: Ligne 1:
 +====== Généralités ======
 +  * Cet assistant permet l'​affichage de la page A Propos, la licence en cours, et de la page d'aide d'un logiciel ou module de MedinTux.
 +  * Ce programme est destiné à être appelé par les autres programmes lorsqu'​ils ont besoin d'​afficher les informations générales et l'aide en ligne les concernant.
 +  * Cet assistant permet aussi de disposer d'un navigateur internet léger pouvant être appelé dans une macro MedinTux. Pour cela, dans le premier argument d'​appel,​ doit se trouver la mention BrowserOnly.
 +  * Cet assistant permet aussi de disposer d'un transmetteur de mail pouvant être appelé dans une macro MedinTux. Pour cela, dans le premier argument d'​appel,​ doit se trouver la mention **MailOnly**.
 +  * Cet assistant permet aussi de disposer d'une imprimante PDF pouvant être appelé dans une macro MedinTux. Pour cela, dans le premier argument d'​appel,​ doit se trouver la mention **ToPDF**.
 +
 +===== Traitement particulier de certains liens =====
 +Si un lien du type **mailto:​truc@machin.org?​subject=ici** mettre le sujet du mail&​body=ici mettre le corps du message est activé par un utilisateur,​ l'​utilitaire d'​envoi de mail est exécuté avec, si ils sont présents, le sujet et le corps du message.
 +Il est possible d'​indiquer au début du corps du message la mention **$File** ou file: suivie du chemin d'un fichier texte contenant le corps du message. Ce fichier peut être exprimé en relatif comme ci-après : ../​../​../​Doc/​mail.txt ​
 +
 +  * exemple : mailto:​truc@machin.org?​subject=ici mettre le sujet du mail&​body=file:​../​../​../​Doc/​mail.txt
 +  * exemple : mailto:​truc@machin.org?​subject=ici mettre le sujet du mail&​body=$File../​../​../​Doc/​mail.txt
 +  * exemple : Envoyer un mail à l'​auteur de MedinTux : envoyer
 +
 +Si un lien du type exec:​../​../​Manager/​bin/​Manager||arg1||arg2 est activé par un utilisateur,​ le programme indiqué à la suite de la mention exec: est exécuté avec en paramètres les arguments séparés par ||.
 +
 +__exemples :__
 +  * Lancer Manager : Gestion de la liste des patients et lancement du dossiers patients.
 +  * Lancer Gest User : Gestion des profils utilisateurs bandeaux et pieds de pages des documents.
 +  * Lancer Set Bases : Gestion des bases, compilation des modules, connexion aux serveurs de données.
 +  * Lancer l'​Annuaire : Gestion des contacts pouvant être liés au patient.
 +
 +====== Appel par les autres programmes ou dans une macro Medintux ​ ======
 +===== Mode afficheur d'​information module ​ =====
 +Appel : Premier argument : nom du module pour lequel ​
 +                               ​APropos doit afficher des infos. ​                              
 +          Deuxième argument : description brève du module ​
 +                               ​(programme qui fait ci et ça...). ​                              
 +          Troisième argument : numéro de version du programme. ​                              
 +          Quatrième argument : le chemin de ce texte(fichier ​
 +                               ​décrivant les Changements). ​                               ​
 +          Cinquième argument : (facultatif) le chemin de l'​icône du programme.
 +                               si cet argument est absent ou indique un fichier ​
 +                               non existant, '​APropos'​ tentera d'​utiliser ​
 +                               une icône du nom du module suivie de l'​extension '​.png'​
 +                               ​présente dans un répertoire ayant le même nom que 
 +                               le 'nom du module',​ lui-même situé dans le répertoire
 +                               '​Doc'​ de MedinTux. ​
 +                               ​Exemple : '​Doc/​Manager/​Manager.png'​.
 +          Sixième argument : (facultatif) le chemin de l'aide en ligne. ​
 +                               si cet argument est absent ou indique une page 
 +                               non existante, '​APropos'​ tentera d'​afficher ​
 +                               une page '​index.html'​ présente dans un répertoire
 +                               ayant le même nom que le 'nom du module',​ lui-même
 +                               ​situé dans le répertoire '​Doc'​ de MedinTux.
 +                               ​Exemple : '​Doc/​personnes/​index.html'​.
 +          Septième argument ​ : (facultatif) le chemin de la page html remplaçant
 +                               celle standard par défaut de l'​onglet A Propos.
 +
 +                               Y NOTER :
 +                               ​---------
 +                               tag {{NUM_VERSION}} qui sera remplacé par le numéro de version
 +                               tag {{MODULE}} qui sera remplacé par le nom du module
 +                               tag {{DESCRIPTION}} qui sera remplacé par une courte description du module
 +                               tag {{ICONE}} qui sera remplacé par le chemin de l'​icône du module
 +<code C++ Appel en C++>
 +void C_Classe::​Slot_APropos()
 +{
 + ​QString pathExeAPropos = CGestIni::​Construct_Name_Exe("​APropos",​QFileInfo (qApp->​argv()[0]).path());​
 + ​QStringList argList;
 + //​....... renseigner arguments .........
 + ​argList << "​Manager"; ​                                                      // 1 nom du module
 + ​argList << tr("​Module de gestion de l'​agenda et de la liste des patients"​);​ // 2 description courte
 + ​argList << NUM_VERSION; ​                                                    // 3 numero de version
 + ​argList << G_pCApp->​m_PathAppli+"​Ressources/​Changements.html"; ​             // 4 fichiers des changements
 + ​argList << G_pCApp->​m_PathAppli+"​Ressources/​Icone.png"; ​                    // 5 fichiers icone
 +
 + ​QProcess proc;
 + ​proc.start(pathExeAPropos,​ argList);
 + ​proc.waitForStarted (-1);
 + ​proc.waitForFinished (-1); 
 +
 +}
 +</​code> ​                          
 +===== Mode mini navigateur web =====
 +Appel : Premier argument : Si cet argument comporte la mention BrowserOnly,​
 +                               ​APropos se comportera comme un navigateur internet et
 +                               le deuxième argument sera l'URL (adresse internet de la page à afficher).
 +                               
 +          Deuxième argument : Si le premier argument comporte la mention BrowserOnly.
 +                               ​APropos se comportera comme un navigateur internet et
 +                               le deuxième argument sera l'URL (adresse internet de la page à afficher).
 +<code - exemple d'​appel mode navigateur>​
 +{{::​exe_process (NoWaitEnd ,​../​../​APropos/​bin/​APropos,​BrowserOnly,/​home/​ro/​MedinTux-V2.14-Synth-src/​Programmes/​Doc/​Changements-V-2.14/​Changements-V-2.14.html)}}</​code>​
 +===== Mode transmetteur de mail =====
 + Appel : Premier argument : Si cet argument comporte la mention MailOnly,
 +                               ​APropos se comportera comme un transmetteur de mail internet et
 +                               le deuxième argument sera alors l'URL (adresse mail du destinataire).
 +                               le troisieme argument sera alors le sujet du mail
 +                               le quatrième argument sera alors le corps du mail
 +          Deuxième argument : Si le premier argument comporte la mention MailOnly,
 +                               ​APropos se comportera comme un transmetteur de mail internet et
 +                               le deuxième argument sera alors une chaîne de caractère de la forme.
 +                               dont la syntaxe est celle de mailto:
 +<code - Exemple appel mode mail>
 +{{:: exe_process (NoWaitEnd ,​../​../​APropos/​bin/​APropos,​MailOnly,​roland-sevin@medintux.org?​subject=Salut tout le monde&​body={{GET_SELECTION}})}} ​
 +{{:: exe_process (NoWaitEnd ,​../​../​APropos/​bin/​APropos,​MailOnly,​roland-sevin@medintux.org?​subject=Salut tout le monde&​body=file:​../​../​fichierDuCorpsDuMail.txt)}} ​
 +</​code>​
 +===== Mode impression en PDF =====
 + Appel : Premier argument : Si cet argument comporte la mention ToPDF,
 +                               ​APropos se comportera comme une imprimante PDF
 +                               le deuxième argument sera le fichier html à imprimer en PDF.
 +                               le troisieme argument facultatif sera le fichier de destination PDF
 +                               si il est vide alors le fichier PDF aura le même nom que le fichier html
 +                               à l'​extension près.
 +          Deuxième argument : Si le premier argument comporte la mention ToPDF,
 +                               ​APropos se comportera comme un transmetteur de mail internet et
 +                               le deuxième argument sera le fichier html à imprimer en PDF.
 +          Troisième argument : Si le premier argument comporte la mention ToPDF,
 +                               ​APropos se comportera comme un transmetteur de mail internet et
 +                               le troisieme argument facultatif sera le fichier de destination PDF
 +                               si il est vide alors le fichier PDF aura le même nom que le fichier html
 +                               à l'​extension près
 +<code - Exemple d'​appel d'​impression PDF>
 +{{\
 +{{:: EXPORT(../​../​tmp/​{{NOM PRENOM PATIENT}}-{{GUID}}.html , d,​Terrain|Observation|Prescription|Documents|Vigie,​1900-01-01T00:​00:​00,​2200-01-01T00:​00:​00,​$File../​../​pdf/​SeparateurEntete.html,​file:​../​../​pdf/​ObservEntete.html) }}\
 +{{:: exe_process (NoWaitEnd ,​../​../​APropos/​bin/​APropos,​ToPDF,​$ToAbsPath../​../​tmp/​{{NOM PRENOM PATIENT}}-{{GUID}}/​{{NOM PRENOM PATIENT}}-{{GUID}}.html)}}\
 +}}
 +</​code>​
 +<​note> ​ dans cet exemple on exporte tout le dossier d'un patient et on l'​adresse à l'​imprimante PDF</​note>​
 +
 +
 +
 +
 +
 +
 +
  
apropos.txt · Dernière modification: 2011/08/24 21:36 (modification externe)