Magazine Pom's : la collection

pcnnettant ainsi à la routine d'afficher des dialogues, ou
d'enregistrer des réglages.
Pour enregistrer des réglages, on peut ajouter une ressource
au système (ce que déconseille Apple, qui n'aime pas trop
que l'on touche à ses fichiers système).
En revanche, c'est impossible pour les ressources de type
DLOG, MENU OU STR ; on a alors le choix entre deux
solutions, dont aucune n'est pleinement satisfaisante :
.. Comme les accessoires de bureau, coder "en dur" ,
soit les chaînes de caractères, soit les dialogues, directe­
ment dans le code (auquel cas toute traduction ou
personnalisation de la FKey est impossible) ;
.. Utiliser un fichier externe, par exemple, à installer
dans le dossier système (l'installation de la FKey est
alors plus compliquée).
C'est la deuxième solution qui a été choisie pour NoteKey.
V NoteKey doit lire des événements par des appels à Get
OSEvent et non à GetNextEvent, qui risquerait de
provoquer des "plantages", lorsque la FKey est appelée par
un accessoire de bureau.
tI' NoteKey doit rester en mémoire après son appel. En ef-
fct. pour effectuer son travail, NoteKey appelle Il fois
PostEvent pour ajouter dans la file des événements, ceux
correspondant à la frappe des Il caractères de la chaîne à
envoyer. Seulement, si la file contient moins de Il places
libres, on risque de perdre des caractères. Il faut donc
installer une routine qui, à chaque appel de GetNextEven t
(ou équivalent), regarde s'il reste de la place dans la file, et
si c'est la cas, y place le caractère suivant. Une fois son
travail tenniné, le code peut enfin être libéré.
La routine espionne
Malheureusement, la fonction qui exécute les FKeys a la
mauvaise idée d'unlocker la ressource après son exécution.
Or, notre routine qui "espionne" GetNextEvent doit rester
fixe en mémoire. La première chose que fa it notre routine
est dont de se "rclocker", en espérant, qu'entre temps, elle
n'aura pas été déplacée.
Une méthode plus propre et sûre serait de se créer un bloc
non-rclogeable avec NewPtr, d'y recopier le code de la
routine "espionne", et les variables qu'elle utilise. La seule
petite difficulté (en langage C, mais pas en assembleur), est
de permettre à la routine de retrouver l'adresse de ses
variables.
Pour installer la routine "espionne", on utilise une globale
non documentée dans Inside Macintosh : JGNEFil tar
(Ox29A), qui contient l'adresse d'une routine à exécuter
après ('appel de GetNextEvent.
Notre FKey, après avoir préparé la chaîne li envoyer, se
détache du fichier de ressources auquel elle est attachée, se
"locke" en mémoire, se marque non-purgcable, récupère
Porn's nO 47
l'ancienne adresse placée en JGNEFi lter, puis y place
l'adresse de notre espionne.
L'espionne, après chaque appel, exécute l'ancienne routine
installée en JGNEFilter, puis, à la suite du dernier appel,
se marque "unlock" et purgeable, pour libérer la mémoire
utilisée, et replace en JGNEFi lter l'adresse de l'ancienne
routine. Avant cette opération, il serait plus sûr de vérifier
que JGNEFi lter contient toujours l'adresse de notre routine
et que rien ne s'est installé à la place.
v NoteKey peut !tre rendu plus solide, en paniculier en
vérifiant que les allocations de mémoire ont été réussies
et que l'on n'appelle pas NoteKey à partir d'elle-même.
v Les autres aspects de NoteKey sont plus "classiques" et
les commentaires inclus dans le listing devraient
permettre de comprendre son fonctionnement et de
l'adapter à vos besoins.
Mode d'emploi
Ceue Fkey permet de définir 9 chaînes de caractères, puis de
les mppeler avec une seule touche.
Installation
Vous installerez NoteKey à l'aide d'un programme tel que
Fkey Installer ou Font/DNMover. Si vous ne possédez pas
d'utilitaire de ce genre, vous pouvez recopier la Fkey 7 li
l'aide de l'éditeur de ressource (tel que ResEdit par
exemple) du fichier NoteKey dans le fichier System. Vous
devrez aussi placer le fichier NoteKey Infos dans le dossier
Système.
Utilisation
NotK1J Infos
Vous appellerez la Fkey à l'aide de commande-7, vous
devrez ensuite taper une autre lettre :
v D ou d : pour insérer l'heure à l'endroit du curseur ;
v Hou h : pour insérer la date à l'endroit du curseur ;
v A ou a : suivi d'un nombre xyz de trois chiffres, de ()(X)
à 255, insère le code ASCII nO "yz à l'endroit du
curseur ;
v 1 à 9 : la chaîne n° x est automatiquement insérée à
l'endroit du curseur ;
tI' Espace : un écran de saisie vous pennet d'enregistrer les
chaînes 1 à 9, ainsi que le format de l'heure et de la
date. Toutes ces chaînes sont enregistrées dans le
fichier NoteKey Infos. Vous les retrouverez donc lors de
votre prochaine utilisation.
t/ Autre : un écran d'aide eSlaffiché.
49