home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / amigalib / d983 / titleclock.lha / TitleClock / TitleClock.doc.fr < prev    next >
Encoding:
Text File  |  1994-04-05  |  8.4 KB  |  226 lines
  1.                  TitleClock V3
  2.             Par Anders Hammarquist
  3.               Traduit par Pascal Rullier
  4.                 pour le BUGSS
  5.  
  6. C'est du DOMAINE PUBLIC. Vous pouvez copiez ce programme librement aussi
  7. longtemps que vous ne faites pas de profits avec lui. Un prix minimal de
  8. copie est autorisé. Fred Fish a une permission explicite pour inclure
  9. TitleClock dans sa collection, ainsi que Pascal Rullier pour l'inclure
  10. dans sa collection BUGSS DP.
  11.  
  12. TitleClock est une petite commodité (environ 4k) qui affiche une horloge
  13. dans la barre de titre des écrans dans le coin en haut à droite. Elle peut
  14. être affichée sur un ou plusieurs écrans, elle peut suivre l'écran public
  15. par défaut et aussi pour s'afficher sur l'écran le plus en avant.
  16.  
  17. Il y a eu quelques changements depuis sa première sortie. Maintenant,
  18. il fonctionne sur des écrans multiples, et aussi sur des écrans
  19. non-publics. Cela se traduit par de nouvelles options, et quelques
  20. changements dans la façon dont le programme opère. Attention aussi à
  21. l'augmentation de la pile (à cause de l'utilisation des fonctions des
  22. substitutions des motifs de la dos.library). Depuis la version 2, le
  23. support pour FormatDate() de la locale.library a été rajouté.
  24. Certaines parties du code a été nettoyé, et, à la demande générale,
  25. vous pouvez voir le code. Le problème concernant les polices de
  26. caractères proportionnels présent dans la version 2 a été aussi
  27. corrigé. Vous ne devez plus avoir des renvois du premier caractère
  28. à gauche de la chaîne, mais le texte peut encore saccadé en avant et
  29. en arrière quand le texte change. Malheureusement, le problème n'est
  30. pas facile à régler, comme savoir sur chaque écran où TitleClock doit
  31. être affiché. Comme maintenant, TitleClock ne se souvient même pas
  32. sur quels écrans il a été affiché du second au suivant.
  33.  
  34. TitleClock accepte les arguments suivants, entrés sur la ligne de
  35. commandes du CLI et dans le champs du type d'outil de l'icône si il a
  36. été lancé du Workbench.
  37.  
  38. UPDATE=
  39.  
  40.     Nombre de secondes entre les mises à jour de l'horloge. Il n'est
  41.     pas recommandé que vous mettez cette valeur à 0. Bien sûr vous
  42.     pouvez, cela chargera le CPU énormement, puisque TitleClock
  43.     n'attendra pas. Aussi, vous ne voulez pas probablement donner une valeur
  44.     trop grande, aussi l'horloge sera effacée à chaque fois que Intuition
  45.     change le titre de l'écran, il n'y aura pas de mettre à mettre une
  46.     TitleClock sur lui avec UPDATE mis à 60 secondes. La valeur par défaut
  47.     est de 1 seconde.
  48.     Veuillez noter que il tient compte des valeurs négatives, si vous
  49.     mettez UPDATE à -1, cela sera mis à jour toutes les 4 294 967 295
  50.     secondes.
  51.  
  52. SHOWDATE
  53.  
  54.     Si présent, TitleClock montrera la date du jour en plus de l'heure
  55.     courante.
  56.  
  57. SHOWDAY
  58.  
  59.     Si présent, TitleClock montrera le jour en plus de l'heure courante.
  60.  
  61. SHORTDAY
  62.  
  63.     Si présent, le nom du jour sera tronqué aux trois premiers caractères.
  64.  
  65. SHOWSECS
  66.  
  67.     Si présent, TitleClock affichera les secondes ainsi que les heures et
  68.     les minutes.
  69.  
  70. FORMAT=
  71.  
  72.     Positionne le format de la date affichée. Il peut être un des suivants:
  73.  
  74.     DOS         - affiche comme jj-mmm-aa
  75.     International   - affiche comme aa-mmm-jj
  76.     Americain        - affiche comme mm-jj-aa
  77.     Canadien        - affiche comme jj-mm-aa
  78.  
  79.     La valeur par défaut est DOS.
  80.  
  81. DATEFORMAT=
  82.  
  83.     Spécifie un format de chaîne pour la date/heure à être affichée dans le
  84.     titre de l'écran. Cette option a besoin que vous avez la locale.library
  85.     d'installée (disponibles avec la version 2.1 du WorkBench ou plus). Si
  86.     vous ne l'avez pas, cette option sera simplement ignorée. Attention,
  87.     cette option supprime toutes les autres options que vous avez
  88.     spécifiées si vous avez la locale.library. Vous pouvez spécifier
  89.     n'importe quel texte que vous voulez dans la chaîne et insérer le jour
  90.     et l'heure courants dans votre langage par défaut en utilisant les
  91.     séquences % suivantes :
  92.  
  93.         %a - nom abbrégé du jour de la semaine
  94.         %A - nom du jour de la semaine
  95.         %b - nom du mois abbrégé
  96.         %B - nom du mois
  97.         %c - semblable à "%a %b %d %H:%M:%S %Y"
  98.         %C - semblable à "%a %b %e %T %Z %Y"
  99.         %d - numéro du jour suivi de 0 espace
  100.         %D - semblable à "%m/%d/%y"
  101.         %e - numéro du jour suivi d'espaces
  102.         %h - nom abbrégé du mois
  103.         %H - heure au style 24 heures suivie de 0 espace
  104.         %I - heure au style 12 heures suivie de 0 espace
  105.         %j - date du calendrier julien
  106.         %m - numéro du mois suivi de 0 espace
  107.         %M - le nombre de minutes suivi de 0 espace
  108.         %p - Chaînes AM ou PM
  109.         %q - heure au style 24 heures
  110.         %Q - heure au style 12 heures
  111.         %r - semblable à "%I:%M:%S %p"
  112.         %R - semblable à "%H:%M"
  113.         %S - nombre de secondes suivi de 0 espace
  114.         %T - semblable à "%H:%M:%S"
  115.         %U - numéro de la semaine, prenant Dimanche comme premier jour
  116.          de la semaine
  117.         %w - numéro du jour de la semaine
  118.         %W - numéro du jour de la semaine, prenant Lundi comme premier
  119.          jour de la semaine
  120.         %x - semblable à "%m/%d/%y"
  121.         %X - semblable à "%H:%M:%S"
  122.         %y - année utilisant deux chiffres suivie de 0 espace
  123.         %Y - année utilisant quatre chiffres suivie de 0 espace
  124.  
  125.     Dans les futures versions du système, Commodore peut ajouté plus de
  126.     chaînes de format. En particulier, %Z peut être un jour implémenté. A
  127.     l'heure actuelle, %Z n'existe pas, mais %C essaye de l'utiliser, lequel
  128.     a des effects plutot intéressants, faisant de la chaîne %C plutôt
  129.     inutile jusqu'à ce moment. Si vous voulez inclure un simple signe %
  130.     dans l'affichage, entrer %% dans le format de la chaîne.
  131.     Quelques exemples :
  132.  
  133.     DATEFORMAT=Temps actuel: %T
  134.  
  135.     Ce qui donnera :
  136.  
  137.     Temps actuel: 15:06:12
  138.  
  139.     DATEFORMAT=%Hh%M, le %e %B
  140.  
  141.     Ce qui donnera :
  142.  
  143.     15h06, le  7 Janvier   (sous 2.1+)
  144.     15h06, le  7 January   (sous 2.0)
  145.  
  146.  
  147. PUBSCREEN=
  148.  
  149.     Dit à TitleClock sur quel écran public il doit apparaître. Cela peut
  150.     être un motif standard AmigaDos, dans lequel l'horloge apparaîtrera sur
  151.     tous les écrans pour lesquels le motif correspond. Le motif est
  152.     sensible aux majuscules. Veuillez noter que la spécification d'un
  153.     motif, si vous avez beaucoup d'écrans publics affectera les
  154.     performances de votre système.
  155.  
  156. SCREENPAT=
  157.  
  158.     Dit à TitleClock sur quel écran non-public il doit apparaître. Cela peut
  159.     être un motif standard AmigaDos, comparé au titre par défaut de les
  160.     écrans système. Le motif est sensible aux majuscules. Noter que le
  161.     titre par défaut d'un écran peut ne pas être le même que celui qui est
  162.     affiché. Par exemple, le titre par défaut de l'écran du Workbench est
  163.     'Workbench Screen'. Veuillez noter que la spécification d'un motif, si
  164.     vous avez beaucoup d'écrans publics affectera les performances de votre
  165.     système.
  166.  
  167. FRONTSCREEN
  168.  
  169.     Si cette option est spécifiée, TitleClock affichera une horloge sur
  170.     l'écran le plus en avant.
  171.  
  172. DEFSCREEN
  173.  
  174.     Si cette option est spécifiée, TitleClock affichera une horloge sur
  175.     l'écran public par défaut.
  176.  
  177. CX_PRIORITY=
  178.  
  179.     Mets la priorité de la commodité TitleClock. La valeur par défaut est
  180.     0.
  181.  
  182. TOOLPRI=
  183.  
  184.     Mets la priorité de la tâche TitleClock. La valeur par défaut est 0.
  185.  
  186. Si vous ne spécifiez aucune des options PUBSCREEN, SCREENPAT, FRONTSCREEN,
  187. ou DEFSCREEN, vous n'aurez pas d'horloge. Aussi, l'horloge ne sera pas
  188. affichée sur n'importe quel écran dont le titre est caché, comme sur un bon
  189. nombre de programmes de terminal. Attention au fait que le conservateur
  190. d'écran inclu dans le 3.0 NE cache PAS le titre, alors vous aurez une
  191. horloge dessus si vous spécifiez FRONTSCREEN (vous ne pouvez pas
  192. l'intercepter par un motif, tant que c'est NULL. Cela a été découvert avec
  193. Enforcer).
  194.  
  195. Si vous mettez TitleClock dans votre tiroir WBStartup, le Workbench aime
  196. voir un type d'outil DONOTWAIT
  197.  
  198. Cela est ainsi.
  199.  
  200. Remerciements à :
  201.  
  202.     Gaël Marziou - pour ses bonnes idées, et son aide avec la locale.library
  203.     Pascal Rullier - pour la traduction du manuel en Français *8)
  204.     Tous les utilisateurs qui m'ont écrits - pour leurs bonnes idées, pour
  205.     m'avoir rendu heureux de faire quelque chose d'utile. Désolé si
  206.     votre idée n'est pas encore implémentée.
  207.     Tous ceux qui font de l'Amiga ce qu'il est.
  208.  
  209. Questions, commentaires, rapports d'erreurs, etc... à :
  210.  
  211. Internet:
  212.     f92anha@dd.chalmers.se
  213.     -ou-
  214.     Anders_Hammarquist@p16.f123.n203.z2.fidonet.cd.chalmers.se
  215.  
  216. FidoNet:
  217.     Anders Hammarquist 2:203/123.16
  218.  
  219. Surplus de disques durs, mémoire, les cartes Ethernet que vous n'utilisez
  220. pas, n'importe quoi à me donner (ainsi que du courrier) à :
  221.  
  222.     Anders Hammarquist
  223.     Schottisvägen 17
  224.     S-424 38  Angered
  225.     Suède
  226.