<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
	"http://www.w3.org/TR/html4/strict.dtd">

<HTML lang="fr">

<HEAD>

<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="Author" lang="fr" content="Vincent Lefvre">

<TITLE lang="en">TitleMenu 3.04 (2003-05-25)</TITLE>

</HEAD>

<BODY>

<DIV style="text-align: center">

<H1 lang="en">TitleMenu 3.04 (2003-05-25)</H1>

<P>crit par <A href="http://www.vinc17.org/">Vincent Lefvre</A></P>

</DIV>

<DIV class="section">

<H2><A name="descr">Description</A></H2>

<DIV class="subsection">

<H3><A name="menus">Menus et barre de titre</A></H3>

<P>Cet utilitaire vous permet de faire apparatre un menu contenant un
rpertoire et ses anctres en cliquant avec le bouton <CITE>Menu</CITE>
sur la barre de titre d'une fentre. Il y a deux sortes de menus:</P>

<DL>

<DT><A name="menudoc">Menus document</A>
<DD>Un tel menu est dfini quand le premier mot du titre de la fentre
est un nom de fichier avec chemin complet. C'est le cas d'une fentre
du <CITE lang="en">filer</CITE> ou d'une fentre contenant un document
(fentre document d'un diteur de textes comme <CITE>Zap</CITE> ou
<CITE lang="en">StrongED</CITE>, ou de <CITE lang="en">Draw</CITE>, par
exemple). Le menu se compose alors du rpertoire contenant le fichier
en question et de tous ses anctres.

<DT><A name="menuapp">Menus application</A>
<DD>Un tel menu est dfini quand l'application propritaire de la fentre
a positionn une variable <VAR><EM>Application</EM>$Dir</VAR>, indiquant
le rpertoire de l'application. Le menu se compose alors de ce rpertoire
et de tous ses anctres; de plus, si ce rpertoire contient un fichier
<CITE lang="en">!Help</CITE>, alors le menu aura une entre supplmentaire
<SAMP lang="en">Help</SAMP> pour obtenir l'aide sur cette application.

</DL>

<P>Par dfaut, c'est le menu document qui est affich, mais cela peut
tre chang via des <A href="#modes">modes</A>. L'autre menu peut tre
affich en appuyant sur une <A href="#key">touche spciale</A> (par
dfaut, <CITE lang="en">Shift</CITE>).</P>

<P>La slection d'une entre d'un de ces menus ouvrira le rpertoire
correspondant ou affichera l'aide de l'application. Ces menus contiennent
deux autres entres:</P>

<UL>

<LI><SAMP lang="en">Info</SAMP>, pour d'obtenir la <A href="#info">bote
d'information</A> standard sur le programme ou afficher (par un clic sur
<SAMP lang="en">Info</SAMP>) ce fichier d'aide;

<LI><SAMP lang="en">Quit</SAMP>, pour quitter
<CITE lang="en">TitleMenu</CITE>.

</UL>

</DIV>

<DIV class="subsection">

<H3><A name="closeicon">Icne de fermeture</A></H3>

<P>Un clic avec le bouton <CITE>Menu</CITE> sur une icne de fermeture
permet d'ouvrir le premier rpertoire du menu correspondant, sans passer
par ce menu (dans une fentre du <CITE lang="en">filer</CITE>, cela est
quivalent  un <CITE lang="en">Open parent</CITE>). Cette fonctionnalit
peut tre dsactive en changeant le <A href="#modes">mode</A> courant.</P>

</DIV>

<DIV class="subsection">

<H3><A name="key">Touche spciale</A></H3>

<P>Une touche spciale permet d'afficher l'autre menu que celui choisi
par prfrence. Cette touche spciale peut tre change  l'aide de la
commande <KBD lang="en">*TitleMenuSKey</KBD>; donner en argument le
code de la touche (de 0  127). La commande sans argument renvoie le
code de la touche courante. Les principaux codes sont donns par le
tableau suivant:</P>

<TABLE border=1>
<TR align="center"><TH><TH>Shift<TH>Ctrl<TH>Alt
<TR align="center"><TH>G &amp; D<TD>0<TD>1<TD>2
<TR align="center"><TH>Gauche<TD>3<TD>4<TD>5
<TR align="center"><TH>Droite<TD>6<TD>7<TD>8
</TABLE>

<P>Vous pouvez aussi utiliser le bouton droit de la souris: code 11.</P>

<P><SMALL>Note: ces codes correspondent  ceux utiliss pour le
<ABBR>SWI</ABBR> <CODE>OS_Byte&nbsp;121</CODE>.</SMALL></P>

</DIV>

<DIV class="subsection">

<H3><A name="obeydir">Liste <VAR>Obey$Dir</VAR></A></H3>

<P>Il existe une autre mthode pour connatre le rpertoire d'une
application: lorsqu'une application est lance, le rpertoire peut tre
lu dans la variable <VAR>Obey$Dir</VAR>. Comme cette mthode n'est pas
totalement sre (mme si elle semble meilleure), elle n'est pas active
par dfaut; en particulier, le rpertoire sera incorrect si l'application
n'est pas lance  partir d'un fichier <CITE>Obey</CITE>. Pour activer ou
dsactiver cette mthode, utiliser les <A href="#modes">modes</A>.</P>

<P>La commande <KBD lang="en">*TitleMenuODL</KBD> donne la liste des
tches pour lesquelles la valeur de la variable <VAR>Obey$Dir</VAR> a
t mmorise. La commande <KBD lang="en">*TitleMenuRemove</KBD> permet
de retirer une tche de cette liste (le <SPAN lang="en">handle</SPAN> de
la tche, donn par <KBD lang="en">*TitleMenuODL</KBD>, doit tre fourni
en paramtre).</P>

</DIV>

<DIV class="subsection">

<H3><A name="modes">Modes</A></H3>

<P>Vous pouvez afficher ou changer le mode courant avec la commande
<KBD lang="en">*TitleMenuMode</KBD>. Le mode est un entier de 0  255,
et 0 est le mode par dfaut. Les diffrentes possibilits sont donnes
ci-dessous.</P>

<UL>

<LI>Ajouter 1 au mode pour dsactiver le clic avec <CITE>Menu</CITE> sur
l'<A href="#closeicon">icne de fermeture</A>.

<LI>Ajouter 2 au mode pour afficher de prfrence le
<A href="#menuapp">menu application</A> au lieu du
<A href="#menudoc">menu document</A>.

<LI>Ajouter 4 au mode pour n'afficher que le menu choisi en prfrence.
Par exemple, s'il s'agit du <A href="#menudoc">menu document</A> et que
seul le <A href="#menuapp">menu application</A> est dfini, aucun menu
ne sera affich.

<LI>Ajouter 8 au mode pour dsactiver la <A href="#key">touche spciale</A>.

<LI>Ajouter 16 au mode pour activer la <A href="#obeydir">liste
<VAR>Obey$Dir</VAR></A>.

</UL>

<P>Si vous voulez mettre le mode au lancement, ajoutez une espace et
la valeur du mode  la fin de la ligne <SAMP>RMRun</SAMP> dans le
fichier <SAMP>!TitleMenu.!Run</SAMP>. Si la <A href="#obeydir">liste
<VAR>Obey$Dir</VAR></A> est active, il est fortement conseill de
lancer <CITE lang="en">TitleMenu</CITE>  la <EM>fin</EM> de la
squence de <SPAN lang="en">boot</SPAN>.</P>

</DIV>

<DIV class="subsection">

<H3><A name="info">Bote d'information</A></H3>

<P>Vous pouvez cliquer sur le nom <CITE lang="en">TitleMenu</CITE> ou sur
l'auteur <CITE>Vincent Lefvre</CITE>. Si un navigateur web est charg,
cela vous amnera sur mon site web.</P>

</DIV>

</DIV>

<DIV class="section">

<H2><A name="clashes">Conflits</A></H2>

<P>Il y a un conflit avec le module <CITE lang="en">MouseAxess</CITE> de
Christian Flter. Pour pouvoir utiliser <CITE lang="en">TitleMenu</CITE>
et <CITE lang="en">MouseAxess</CITE> en mme temps, il est ncessaire de
dsactiver la fonctionnalit de <CITE lang="en">MouseAxess</CITE> lie 
la barre de titre en modifiant le module <CITE lang="en">MouseAxess</CITE>.
La modification suivante de <CITE lang="en">MouseAxess</CITE>&nbsp;0.17
semble fonctionner, mais comme d'habitude, appliquez-la  vos propres
risques.</P>

<P><CITE>MouseAxess</CITE>&nbsp;0.17e:</P>
<PRE>
         Offset   Mot hexa    Code
------------------------------------------------
Changer   1E58    E3740004    CMN R4,#4
  en      1E58    EA000003    B   &amp;00001E6C
------------------------------------------------
Changer   1ED8    E3740004    CMN R4,#4
  en      1ED8    EA000001    B   &amp;00001EE4
------------------------------------------------
</PRE>

<P><CITE>MouseAxess</CITE>&nbsp;0.17j:</P>
<PRE>
         Offset   Mot hexa    Code
------------------------------------------------
Changer   1E60    E3740004    CMN R4,#4
  en      1E60    EA000004    B   &amp;00001E78
------------------------------------------------
Changer   1EEC    E3740004    CMN R4,#4
  en      1EEC    EA000001    B   &amp;00001EF8
------------------------------------------------
</PRE>

</DIV>

<DIV class="section">

<H2><A name="licence">Licence et distribution</A></H2>

<P><CITE lang="en">TitleMenu</CITE> est <EM>freeware</EM>. Utilisez-le 
vos propres risques. Vous pouvez le distribuer librement  condition que
les fichiers ne soient pas modifis ou retirs et que vous ne fassiez
aucun profit. Le source assembleur est fourni de manire  ce que vous
puissiez le modifier pour vous-mme si vous le voulez; si vous souhaitez
diffuser une version modifie, veuillez me contacter auparavant.</P>

<P>Vous pouvez trouver la dernire version de mes logiciels sur ma
<A href="http://www.vinc17.org/acorn/riscpc_fra.html">page web
Risc&nbsp;PC</A>. Vous pouvez aussi y tlcharger:</P>
<UL>
<LI><A href="http://www.vinc17.org/acorn/titlemenu.zip">la dernire
version de <CITE lang="en">TitleMenu</CITE></A>;
<LI><A href="http://www.vinc17.org/acorn/titlemenu_fra.html">la dernire
version de ce fichier d'aide</A>.
</UL>

<P>Pour tout contact au sujet de <CITE lang="en">TitleMenu</CITE>,
utilisez l'adresse suivante:
<A href="mailto:titlemenu@vinc17.org">titlemenu@vinc17.org</A></P>

</DIV>

<HR>

<ADDRESS>
<A href="mailto:vincent@vinc17.org">Vincent Lefvre
&lt;vincent@vinc17.org&gt;</A>
</ADDRESS>

</BODY>

</HTML>
