EXEMPLE DE DEVELOPPEMENT SUR MACINTOSH

Transcription

1 EXEMPLE DE DEVELOPPEMENT SUR MACINTOSH A L'AIDE DE THINK C G.Blanchet Département SIGNAL

2 2 password.doc

3 DOCUMENTATION DE PASSWORD L'exemple qui suit illustre la façon de développer une application sous THINK C. Cette application, qui consiste en l'acquisition d'un mot de passe, ne comporte qu'une fenêtre de dialogue modal. Ce terme signifie que l'on ne peut traiter que les évènements relatifs à cette fenêtre et qu'il faut en sortir avant de pouvoir faire autre chose. L'application, appelée password, doit s'exécuter lors du démarrage de la machine. Le mot de passe défini par défaut est password. On peut modifier le mot de passe courant, si on l'a donné correctement, en tapant le nouveau mot de passe - dans la figure ci-dessous newpwd - dans la zone de saisie située juste audessus du bouton New. On clique ensuite sur ce dernier puis sur OK ou <retour_chariot>. Cliquer sur le bouton Off provoque l'extinction de la machine. fig.1 La fenêtre de dialogue On peut inhiber la vérification du mot de passe en cliquant sur le bouton de validation (check box) noté Valid. Au démarrage suivant il ne sera pas nécesaire de donner le mot de passe correct pour accéder au finder. Cette application est écrite à l'aide de Think C 5.0 et de ResEdit version Le dialogue La première chose à faire est de définir l'ensemble des dialogues donc les fenêtres dont on aura besoin. La fenêtre principale est de type dialogue (DLOG). C'est celle qui est représentée figure 1. On devra disposer aussi de deux fenêtres de type alerte (ALRT) :

4 2 password.doc une fenêtre de confirmation associée aux boutons Off et New, une fenêtre indiquant que le mot de passe donné est incorrect. \s\up12( ) fig.2 Les fenêtres d'alerte Création du fichier de ressources Pendant la phase de mise au point, le nom du projet étant password.π, THINK C va en chercher les ressources dans le fichier nommé password.π.rsrc. Le nom peut être écrit en majuscules ou minuscules. On lance ResEdit puis on créé ce fichier. On peut ensuite passer à la création des ressources. On prendra soin de relever les numéros des ressources qui sont créées pendant cette phase du travail. création d'une ressource dialogue (DLOG) : fig.3 La création de la fenêtre principale La ressource DLOG contient en fait une liste d'objet de type DITL (Dialog Item List) dans laquelle on définira :

5 password.doc 3 deux zones de saisie (TextEdit ou TEdit) pour le mot de passe courant et le nouveau mot de passe, trois boutons New, Off et OK, un élément de texte (Static Text) 'Password :', une boîte de controle (Check Box) : Valid, une image PICT. Double-cliquer sur la fenêtre visualisée sur l'écran : fig.4 L'écran pour la création de la fenêtre DLOG On peut maintenant définir les objets de contrôle dans cette fenêtre : boutons, textes, images, etc. ResEdit permet de construire très rapidement la fenêtre à partir de la palette d'objets disponibles. Une fois les objets placés sur la fenêtre, il faut organiser ceux-ci logiquement (numérotation des items) en prenant soin de donner le numéro 1 au bouton OK. Il est en effet d'usage d'associer <retour_chariot> et l'item 1. On relève ces numéros qui serviront lors de la phase de programmation.

6 4 password.doc fig.5 La liste DITL des objets de contrôle création de la ressource PICT 128 devant servir dans la fenêtre DLOG. On utilise une image créée par un des nombreux logiciels utilisant ce format et on la colle dans cette ressource. on passe ensuite à la création des deux ressources de type ALERT. Celles-ci font appel, comme la ressource DLOG, à une liste DITL auxquelles on affectera les numéros 129 et 130. La ressource DITL 129 comporte une icône (ICON) utilisée dans la fenêtre d'alerte 128 : ResEdit dispose d'un outil de dessin de type Paint permettant de construire directement cette icône.

7 password.doc 5 fig.6 Construction de l'icône création de deux ressources de type 'STR ' qui recevront respectivement le mot de passe (128) et un marqueur indiquant l'état de la check box de validation (129). On aurait pu aussi utiliser une ressource STR# recevant une liste de chaînes de caractères. La première chaîne contient "password" qui est le mot de passe par défaut et la seconde le caractère 'V' ou 'N' selon l'état du bouton de validation. On peut récapituler de la façon suivante l'ensemble des ressources utilisées par l'application : fig.7 Les ressources de l'application

8 6 password.doc La fenêtre de dialogue a pour numéro 128. La première fenêtre d'alerte possède le numéro 128, la liste DITL 129 comportant une l'icône de numéro 128. La seconde fenêtre d'alerte a pour numéro 129 avec une liste DITL 130 : Le programme Le programme possède la structure suivante : Lecture des 'STR ' passwordress et du caractère de validation pour mise à jour du booléen ivalid. Lecture de la ressource 'DLOG'. Affichage de la chaîne secret et mise à jour de la check box en fonction de ivalid. Tant que pas_fini Lire les évènements (ModalDialog) : case item OK Off New Zone d' édition password Zone d' édition du nouveau password Case de validation En principe le dialog manager prend en charge la gestion de la fenêtre DLOG que l'on a défini. La difficulté provient du fait que l'on ne veut pas afficher les caractères tapés par l'utilisateur dans la zone d'acquisition du mot de passe. Il faut donc utiliser la procédure de filtrage prévue pour un tel type d'utilisation. Celle-ci consiste à filtrer les caractères tapés dans la zone d'acquisition (item#4) : les seuls caractères de contrôle qu'on laisse passer sont les caractères flèches et Rubout en laissant le dialog manager les traiter. et on remplace les caractères normaux (code ASCII entre 0x20 et 0xFF) par le caractère 0xF0 (la pomme).

9 password.doc 7 /* */ /* Programme.c */ /* */ #include <Windows.h> #include <string.h> #include <Dialogs.h> #include <Controls.h> #include <ShutDown.h> #define MYDIALOG 128 #define MYALERT1 128 #define MYALERT2 129 #define MYSTRPWD 128 #define MYSTRVLD 129 #define PWZONE 4 #define NEWPWZONE 5 #define PWCTRL 6 void InitMacintosh(void); pascal Boolean myfilter(dialogptr thedlg, EventRecord *theevent, short *item); void NettoieCh(Str255 chtrav); void rtrim(char *ch); int VerifPWD(char *pw); char password[10]="secret", *resul, chargot; DialogRecord drecord; int chsize; /* */ /* Initialisation des gestionnaires de */ /* ressources et de la mémoire */ /* */ void InitMacintosh(void) MaxApplZone(); InitGraf(&thePort); InitFonts(); FlushEvents(everyEvent, 0); InitWindows(); TEInit(); InitDialogs(0L); InitCursor();

10 8 password.doc /* */ /* Filtrage des caractères tapés : */ /* Caractères normaux -> 'pomme' */ /* Caractères flèches et Rubout OK */ /* */ pascal Boolean myfilter(dialogptr thedlg, EventRecord *myevent, short *item) char thechar; int themodif; chargot = 0; if (drecord.editfield == (NEWPWZONE-1)) return false; if (myevent->what == keydown) thechar = myevent->message & charcodemask; themodif = myevent->modifiers & cmdkey; chargot = thechar; if ((thechar==3) (thechar==0x0d)) *item=1; return true; else if (((thechar>=0x20) (thechar < 0)) && themodif==0) myevent->message &= 0xFFFFFF00; myevent->message = 0xF0; return false; else if ((thechar==8) ((thechar>=28)&&(thechar<=31))) return false; else return true; return false; /* */ /* Verification entre password et passwordress */ /* */ int VerifPWD(char *pwd) if (strcmp(password, pwd) == 0) return(true); else return(false);

11 password.doc 9 /* */ /* On enlève les espaces en fin de chaine */ /* */ void rtrim(char *ch) int i=7; while ((ch[i] == 0x20) && (i>=0)) ch[i]=0 ; i-- ; /* */ /* A partir de password constitue une chaine */ /* chtrav pour l'affichage */ /* */ void NettoieCh(Str255 chtrav) int i=7; memset(chtrav+1, '\0', 8); while ((password[i]<=0x20) && (password[i]>=0) && (i>=0)) password[i]=0 ; chtrav[i+1]=0 ; i-- ; chtrav[0]=i+1; for (i=0;i<=7;i++) if ((password[i]>0x20) (password[i]<0)) chtrav[i+1]= -16 ; /* */ /* main() */ /* On a droit à trois essais */ /* NbEssais = compteur d'essais */ /* ivalid = état du check box de validation */ /* ivalid0 = état du check box de validation */ /* imodifpwd = indique que le PWD a été modifié */ /* */ main() int i=0, NbEssais=0, imodifpwd; int left, top, right, bottom, ivalid=0, ivalid0; int icursposd=0, icursposf=0, D0=0, F0=0; Str255 chpass, chpass0="", chtrav="\p "; DialogPtr thedlogress;

12 10 password.doc Handle stringh, stringhn, stringhc; Handle iressdlog, iressstr1, iressstr2; TEHandle mytezone; Rect box; short item=0, type, typen, typec; char passtrav[10], passwordress[10], ivchar; InitMacintosh(); iressdlog=getresource('dlog', MYDIALOG); if (iressdlog==0) SysBeep(20); return; /* */ /* lecture de la chaine password */ /* et du caract. de validation V ou N */ /* */ iressstr1=getresource('str ', MYSTRPWD); memset(passwordress, 0, 10); resul=memcpy(passwordress, (*iressstr1+1), **iressstr1); rtrim(passwordress); iressstr2=getresource('str ', MYSTRVLD); ivchar=*(*iressstr2+1); ivalid = (ivchar=='v'); ivalid0=ivalid; /* */ /* lecture de ressource dialogue MYDIALOG */ /* et affichage de la chaine password */ /* */ thedlogress = GetNewDialog( (short) MYDIALOG, &drecord,(ptr)-1l ); GetDItem(theDLOGress, PWZONE, &type, &stringh, &box); /*NettoieCh(chTrav);*/ rtrim(password); i=strlen(password); resul=memcpy(chtrav+1, password, i); memset(chtrav, i,1); SetIText(stringH, chtrav); GetDItem(theDLOGress, PWCTRL, &typec, &stringhc, &box); SetCtlValue(stringHC,iValid); SetPort(&dRecord.window); /* */

13 password.doc 11 /* Boucle principale de traitement */ /* */ for (;;) ModalDialog((ProcPtr)myFilter, &item); switch (item) case 1: /* OK */ /* TEDispose(myTEzone); */ if ((!ivalid0) VerifPWD(passWordRess)) /* enregistrer la validation si nécessaire */ if (ivalid0!= ivalid) HNoPurge(iRessSTR2); *(*iressstr2+1)=(ivalid? 'V' : 'N'); ChangedResource(iRessSTR2); WriteResource(iRessSTR2); HPurge(iRessSTR2); /* enregistrer le PWD si nécessaire */ if (imodifpwd) memset(passwordress, '\0', 8); resul=memcpy(passwordress, chpass0+1, *chpass0); HNoPurge(iRessSTR1); i=*chpass0; resul=memcpy((*iressstr1+1), chpass0+1, i); memset((*iressstr1+i+1), ' ', 8-i); ChangedResource(iRessSTR1); WriteResource(iRessSTR1); HPurge(iRessSTR1); DisposDialog(theDLOGress); return(0); else NbEssais++; if (NbEssais == 3) ShutDwnPower() ; break ; case 2: /* Off */ i=alert(myalert2, 0L); if (i==2) ShutDwnPower(); else

14 12 password.doc break; case 3: /* New */ /* validation zone TextEdit - on tape en clair */ if (!VerifPWD(passWordRess)) i=alert(myalert1, 0L); else i=alert(myalert2, 0L); if (i==2) imodifpwd =true; break; case PWZONE: /* TextEdit zone pour password */ GetDItem(theDLOGress, PWZONE, &type, &stringh, &box); /* chargot -> password[10] */ mytezone = drecord.texth; /* Handle vers TERec */ icursposd = (**mytezone).selstart; /* Pos. début curseur */ icursposf = (**mytezone).selend; /* Pos. fin curseur */ if ((chargot>=0x20) (chargot<0)) if (icursposd<9) memset(passtrav, '\0', 8); if (icursposd>0) resul=memcpy(passtrav, password, icursposd); passtrav[icursposd-1]=chargot; if (F0<8) resul=memcpy((passtrav+d0+1), (password+f0), (8- F0)); resul=memcpy(password, passtrav, 8); NettoieCh(chTrav); SetIText(stringH, chtrav); else switch (chargot) case 8: /* Rubout */ GetDItem(theDLOGress, PWZONE, &type, &stringh, &box); mytezone = drecord.texth; /* Handle TERec */ icursposd = (**mytezone).selstart; /* Deb curs. */ icursposf = (**mytezone).selend; /* Fin curseur */ memset(passtrav, '\0', 8); if (icursposd>0) resul=memcpy(passtrav, password, icursposd); if (F0<8) resul=memcpy((passtrav+icursposd), (password+f0), (8-F0)); resul=memcpy(password, passtrav, 8); break; case 28: /* fl.gauche */

15 password.doc 13 break; case 29: /* fl.droite */ break; case 30: /* fl.haut */ break; case 31: /* fl.bas */ break; default: ; D0=iCursPosD; F0=iCursPosF; chargot=0; break; case NEWPWZONE: /* TextEdit zone pour nouveau password */ GetDItem(theDLOGress, NEWPWZONE, &typen, &stringhn, &box); GetIText(stringHN, chpass0); if (chpass0[0]>8) chpass0[0]=8 ; chpass0[9]=0 ; SetIText(stringHN, chpass0); break; case PWCTRL: /* case de validation */ GetDItem(theDLOGress, PWCTRL, &typec, &stringhc, &box); ivalid = (ivalid==0? 1 : 0); SetCtlValue(stringHC,iValid); break; default: ; /* end main */ Modification de l'icône de l'application Une fois l'application construite -THINK C insère automatiquement les ressources dans le fichier application- on peut modifier l'icône de cette dernière. La première modification porte sur l'identification du créateur. Sous ResEdit, on affiche les informations sur l'application (Get Infos ) et on fixe le code créateur à GSIG :

16 14 password.doc fig.8 Modification du créateur On définit ensuite l'icône (ressource ICN#) pour laquelle on choisira le même graphisme que celui qui est utilisé dans la ressource ICON 128.

17 password.doc 15 fig.9 Création de l'icône de l'application On en profite pour définir aussi une icône de petite taille, utilisée par le finder lorsqu'on affiche le contenu d'un dossier par petite icône.

18 16 password.doc Le numéro de la ressource ICN# sera utilisé pour effectuer le lien avec l'application ellemême au travers de la ressource BNDL. La ressource BNDL détient les références à l'icône définie précédemment et à la ressource FREF que nous mettrons à jour ensuite. Celle-ci est automatiquement créée lorsqu'on y fait référence dans la création de la ressource BNDL. Une fois ouverte la fenêtre de définition, créer de nouvelles ressources. Une nouvelle ligne apparaît qui permet d'introduire les informations : APPL pour la ressource FREF avec le numéro 128 et 128 pour le numéro d'icône. Les icônes précédemment définies apparaissent dans la partie droite de la fenêtre. On définit en plus la signature GSIG. Remarque : les identificateurs locaux sont utilisés lorsqu'on a plusieurs ressources ICN# et FREF, par exemple dans le cas où l'application crée des documents avec des icône personnalisées. Dans le cas présent les deux identificateurs locaux sont égaux à 0.

19 password.doc 17 fig.10 La ressource BNDL La ressource FREF 128 est automatiquement créée. On n'a aucune information supplémentaire à définir.

20 18 password.doc fig.11 Caractéristiques de FREF On peut s'assurer que l'identificateur local est bien égal à 0 en en lisant les informations : fig.12 Identificateur local de FREF Créer une nouvelle ressource de type égal au nom de créateur GSIG et contenant la signature de l'application.

21 password.doc 19 Le texte est saisi dans l'éditeur hexadécimal. Le premier caractère donne le nombre de caractères de la chaîne saisie. fig.13 Chaîne d'information Les informations écrites dans cette ressource apparaissent lorsqu'on fait get info sur l'application en question. L'icône ne sera pris en compte que si l'on reconstruit le desktop. Ceci est fait en redémarrant en tenant les touches option et pomme appuyées. fig.14 La fenêtre d'information Organisation des ressources de l'application Les ressources de l'application sont les suivantes :

22 20 password.doc fig.15 Les ressources de l'application Leur organisation logique peut être schématisée :

23 password.doc 21

24 22 password.doc Données application (0) (128) (local ID 0) (128) (local ID 0) APPL Informations application Application fig.16 Organisation logique des ressources Réalisation effective de La réalisation effective comporte un bouton pour accéder à une fenêtre d'aide. Celle-ci est constituée d'une fenêtre d'alerte ALRT 130 avec la liste DITL 131. La procédure de filtrage est modifiée de telle sorte que la touche de tabulation fasse passer d'une zone de saisie à l'autre. En plus une procédure de bypass est utilisable (<pomme-click> sur une zone particulière). Le nombre d'essais infructueux est affiché sous la zone de saisie (2).

25 password.doc 23 fig.17 Ecran de l'application définitive