[Rezilla-commits] RezillaHelp/French.lproj RezillaPluginHowto.html, 1.1, 1.2
Brought to you by:
bdesgraupes
Menu
▾
▴
[Rezilla-commits] RezillaHelp/French.lproj RezillaPluginHowto.html, 1.1, 1.2
|
From: Bernard D. <bde...@us...> - 2006-11-24 08:55:11
|
Update of /cvsroot/rezilla/RezillaHelp/French.lproj In directory sc8-pr-cvs9.sourceforge.net:/tmp/cvs-serv3351 Modified Files: RezillaPluginHowto.html Log Message: Doc complements Index: RezillaPluginHowto.html =================================================================== RCS file: /cvsroot/rezilla/RezillaHelp/French.lproj/RezillaPluginHowto.html,v retrieving revision 1.1 retrieving revision 1.2 diff -u -d -r1.1 -r1.2 --- RezillaPluginHowto.html 1 Nov 2006 16:58:40 -0000 1.1 +++ RezillaPluginHowto.html 24 Nov 2006 08:55:02 -0000 1.2 @@ -397,20 +397,32 @@ identifier la fentre d'dition fournie par l'application, des pointeurs <I>MenuRef</I> si jamais le plugin avait demand l'insertion de menus, etc. </OL><P>Ë ce stade, le plugin peut maintenant faire son travail d'dition de la -ressource. Il peut par exemple crer des contrles et des lments -graphiques, installer des -CarbonEvents sur ces contrles, etc. On notera dependant qu'il n'y a aucune -obligation utiliser des CarbonEvents; toutes les actions et vnements -dclenchs par l'utilisateur sont passs Rezilla sous la forme d'un -EventRecord dans les fonctions suivantes dfinies dans l'interface: -<I>HandleMenu, HandleClick, HandleKeyDown</I> et <I>HandleCommand</I>.<P>Lorsque vient le moment de sauvegarder les modifications faites dans la ressource +ressource. Il peut par exemple crer des contrles et des lments +graphiques, installer au besoin des CarbonEvents sur ces contrles, etc. La +fentre est construite en mode composite (<I>compositing mode</I>) ce qui +permet d'utiliser pleinement le modle HIViews de dessin de l'interface +graphique.<P>On notera dependant qu'il n'y a aucune obligation utiliser des +CarbonEvents; toutes les actions et vnements dclenchs par l'utilisateur +sont passs Rezilla sous la forme d'un EventRecord dans les fonctions +suivantes dfinies dans l'interface: <I>HandleMenu, HandleClick, +HandleKeyDown</I> et <I>HandleCommand</I>.<P>Lorsque vient le moment de sauvegarder les modifications faites dans la ressource (par exemple lorsque l'utilisateur clique sur le bouton <I>Save</I> ou tente de fermer la fentre), Rezilla invoque la fonction <I>ReturnResource</I> afin que le plugin renvoie les donnes modifies, puis la fonction <I>CleanUp</I> -afin qu'il puisse excuter les tches qui mettent fin une session -d'dition, comme par exemple librer les portions de mmoire qui ont t -alloues.<P><H4><A NAME="M15"></A>Les requtes du plugin</H4><P>Cette section donne plus de dtails concernant les requtes formules par +afin qu'il puisse terminer sa session d'dition: +<UL> + <LI> la fonction <I>ReturnResource</I> renvoie une <I>handle</I> sur les +donnes modifies. Elle comporte aussi un argument boolen <I>releaseIt</I> qui indique Rezilla qui est propritaire de cette <I>handle</I> et +qui devra donc librer la mmoire qu'elle occupe. Si cet argument est fix + la valeur <I>true</I> c'est Rezilla qui est responsable de librer la +mmoire, autrement le plugin devra s'en charger.<P> <LI> lorsque la fonction <I>CleanUp</I> est appele, le plugin excute +toutes les tches de post-dition qu'il juge ncessaire, libre la mmoire +qu'il a alloue, etc.<P></UL><P>Si l'utilisateur clique sur le bouton <I>Revert</I> (lorsqu'il y en a +un!), Rezilla invoque la fonction <I>RevertResource</I>: les donnes +auxquelles il faut revenir sont fournies par l'intermdiaire de l'argument +<I>inDataH</I>, ce qui signifie en particulier que le plugin n'a pas se +proccuper de garder une copie des donnes originales.<P><H4><A NAME="M15"></A>Les requtes du plugin</H4><P>Cette section donne plus de dtails concernant les requtes formules par le plugin dans la fonction <I>AcceptResource</I>. La structure <I>RezPlugInfo</I> est dfinie comme ceci: <PRE> typedef struct RezPlugInfo { @@ -460,14 +472,16 @@ | kPluginSupportClear) } </PRE><P>Le membre <I>winbounds</I> est une structure Rect indiquant la position et -dimension de la fentre d'dition. Rezilla fournit toujours une fentre -d'dition qui peut tre quipe d'un certain nombre d'lments de base tels -que des boutons <I>Save</I> et <I>Cancel</I>. Le plugin n'a pas se -proccuper de surveiller ces contrles: ils sont grs par l'application -principale. Le plugin doit simplement dcider, au moyen des drapeaux -adquats, lesquels de ces contrles doivent figurer dans la fentre. Par -exemple, on ajoutera le drapeau <I>kPluginEditorHasRevertButton</I> aux -attributs si l'on souhaite avoir un bouton <I>Revert</I> dans la fentre.<P>Le membre <I>menucount</I> indique combien de menus sont ncessaires au +dimension de la fentre d'dition: elle est exprime en coordonnes +globales et correspond la structure entire de la fentre, autrement les +dimensions qui sont habituellement passes la fonction <I>CreateWindow</I>. Rezilla fournit toujours une fentre d'dition qui peut tre quipe +d'un certain nombre d'lments de base tels que des boutons <I>Save</I> et +<I>Cancel</I>. Le plugin n'a pas se proccuper de surveiller ces +contrles: ils sont grs par l'application principale. Le plugin doit +simplement dcider, au moyen des drapeaux adquats, lesquels de ces +contrles doivent figurer dans la fentre. Par exemple, on ajoutera le +drapeau <I>kPluginEditorHasRevertButton</I> aux attributs si l'on souhaite +avoir un bouton <I>Revert</I> dans la fentre.<P>Le membre <I>menucount</I> indique combien de menus sont ncessaires au plugin (ventuellement 0). Si le plugin dfinit des menus, il doit passer un tableau des MenuIDs correspondants dans le membre <I>menuIDs</I> de la structure. Ces MenuIDs sont les numros de ressources de type 'MENU' qui @@ -888,7 +902,7 @@ </PRE><P><!-- logo SF --> <!-- ------- --> <HR> -<P> Last updated 2006-11-01 15:23:57 +<P> Last updated 2006-11-24 07:15:41 <HR> <P> <I>Rezilla is hosted by</I> <A HREF="http://sourceforge.net"> <P><IMG SRC="http://sourceforge.net/sflogo.php?group_id=83267&type=4 " ALT="SourceForge.net Logo" ALIGN=bottom></P></A><P> |
