Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.

Transcription

1 Aide à la saisie des heures et des dates Par Thierry OZIL, Marketing Technique 4D S.A. Mélinda GALLO, 4D Today Note technique 4D FR Version 1 Date 24 Juillet 2002 Résumé Voici comment saisir, dans 4D, une date ou une heure avec la souplesse des outils utilisés par les PDA. Cette note technique utilise des méthodes de 4D Web Calendar et 4D Calendar écrites par Steve Hussey et Dave Batton. 4D Notes techniques Copyright D SA - Tous droits réservés Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible. Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers. Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support dulogiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés oureproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence. Aucune partie de ce document ne peut être reproduite ourecopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA. 4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA. Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation. Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc. Mac2Win Software Copyright est un produit de Altura Software,Inc. 4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,trumbull,ct,usa. XTND Copyright D SA. Tous droits réservés. XTND Technology Copyright Claris Corporation.. Tous droits réservés ACROBAT Copyright , Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'adobe Systems Inc. Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs. 1 / 9

2 Présentation La base fournie en exemple affiche un dialogue de saisie avec des champs date et heure. Pour saisir la date cliquez sur le calendrier, le dialogue suivant s'affiche. Il permet de sélectionner par simple clic mois, année et jour. 2 / 9

3 Fonctionnement Initialisation Avant d'utiliser ces méthodes, il est nécessaire d'exécuter (dans la méthode base sur ouverture par exemple) la méthode : CLND_Init `Methode : CLND_Init ` Figure out the date system for the Calendar routines. ` US System (mm/jj/aa) :!02/01/02! = 1st Feb 02 ` Euro System (jj/mm/aa) :!02/01/02! = 2nd Jan 02 clnd_daymonthyr:=(jour de(date("02/01/02"))=2) ` Set up an array of month names. TABLEAU ALPHA(20;clnd_Month;12) ENUMERATION VERS TABLEAU("mois";clnd_Month) clnd_amonths:=mois de(date du jour) ` Set the current month. clnd_dateclicked:=date du jour clnd_day:=jour de( clnd_dateclicked) clnd_amonths:=mois de( clnd_dateclicked) clnd_year:=annee de( clnd_dateclicked) clnd_selectedobjectptr:= clnd_nilptr $Size:=24 TABLEAU ALPHA(30;clnd_Hour;$Size) Boucle ($i;1;$size) clnd_hour{$i}:=chaine($i-1;"00")+":00" Cette méthode détermine l affichage des dates du système (format court). Il y a deux possibilités, l affichage européen «jj/mm/aa» et l affichage américain «mm/jj/aa». Pour ce faire on utilise l'instruction : clnd_daymonthyr:=(jour de(date("02/01/1995"))=2) qui retourne vrai lorsque le système d affichage est sous la forme «jj/mm/aa». Le reste de la méthode ne fait qu'initialiser les variables et tableaux pour la suite des traitements. Il est à noter que pour faciliter la localisation, l'intitulé des jours et des mois est lu dans des énumérations. Affichage Un clic sur le calendrier appelle la méthode : CLND_DlgDay_open 3 / 9

4 `Méthode : CLND_DlgDay_open C_POINTEUR($1) C_DATE($2) C_ENTIER LONG($mouseX;$mouseY;$mouseButton;$left;$top;$right;$bottom) C_ENTIER LONG($DialogW;$DialogH;$DialogL;$DialogR;$DialogT;$DialogB) clnd_selectdate:=$1-> POSITION SOURIS($mouseX;$mouseY;$mouseButton;*) COORDONNEES ECRAN($left;$top;$right;$bottom) $DialogW:=176 $DialogH:=206 Si (($mousex+$dialogw)>$right) $DialogL:=$right-$DialogW $DialogR:=$right $DialogL:=$mouseX $DialogR:=$mouseX+$DialogW Si (($mousey+$dialogh)>$bottom) $DialogT:=$bottom-$DialogH $DialogB:=$bottom $DialogT:=$mouseY $DialogB:=$mouseY+$DialogH $WinID:=Creer fenetre($dialogl;$dialogt;$dialogr;$dialogb;1;"";"clnd_close") Si (clnd_selectdate=!00/00/00!) Si (Nombre de parametres=2) clnd_selectdate:=$2 clnd_selectdate:=date du jour(*) DIALOGUE([INTERFACE];"CLND_CalendarSet") Si (OK=1) $1->:=clnd_SelectDate Elle accepte deux paramètres, le premier pointe sur le champ de saisie (type date), le deuxième optionnel, permet de forcer la date par défaut. Cette méthode ouvre un dialogue modal, qui affiche le calendrier aux coordonnées du clic souris, et affecte le champ (paramètre 1) avec la date sélectionnée si le dialogue est validé. 4 / 9

5 À l'ouverture du calendrier, le calendrier affiche la date par défaut. Si un seul paramètre est passé, la date sélectionnée est celle du champ s'il est affecté, dans le cas contraire on affiche la date du jour. Si le deuxième paramètre est passé, c'est ce paramètre qui déterminera la date par défaut. À l'ouverture du dialogue on execute la méthode projet: CLND_Prefs_Set (Dimanche ;Noir ;Gras) Elle personalise l'affichage du calendrier en choisissant le premier jour de la semaine (dimanche ou lundi) ainsi que la couleur et l'attribut du jour sélectionné (noir gras pour dans notre exemple.) `PM: CLND_Prefs_Set $StartWeekDay:=$1 $SelectColor:=$2 $SelectStyle:=$3 Si ($StartWeekDay#-1) clnd_startweekon:=$startweekday Si ($SelectColor#-1) clnd_selectcolor:=$selectcolor Si ($SelectStyle#-1) clnd_selectstyle:=$selectstyle et exécute la méthode projet : CLND_Calendar_Set qui affiche le calendrier mensuel. Cette méthode détermine la position du premier et du dernier jour du mois. Le premier jour de la semaine peut être un dimanche ou un Lundi en fonction de clnd_startweekon $DateDayNum:=Jour de(clnd_selectdate) `get the day number for the selected date $FirstDayDate:=Ajouter a date(clnd_selectdate;0;0;(1-$datedaynum)) `get the date of the first day $NumDays:=Jour de(ajouter a date(clnd_selectdate;0;1;-1)) `get the number of days in the month $MonthNum:=Mois de(clnd_selectdate) `get the month $YearNum:=Annee de(clnd_selectdate) `get the year ` Determine the first and last boxes used to display this month. Si ( clnd_daymonthyr) $DayNum:=Numero du jour(date("1"+"/"+chaine($monthnum)+"/"+chaine($yearnum))) $NumDays:=Jour de(date("1/"+chaine($monthnum+1)+"/"+chaine($yearnum))-1) `get the number of days in the month $DayNum:=Numero du jour(date(chaine($monthnum)+"/"+"1"+"/"+chaine($yearnum))) $NumDays:=Jour de(date(chaine( clnd_amonths+1)+"/1/"+chaine( clnd_year))-1) `get the number of days in the month `determine the offset $StartOffset:=8-clnd_StartWeekOn 5 / 9

6 Si ($StartOffset=7) $StartOffset:=0 clnd_offset:=$daynum+$startoffset-1 Si (clnd_offset>=7) clnd_offset:=clnd_offset-7 elle affecte les variables texte clnd_weekdayx qui affichent l'intitulé des jours de la semaine. `fill the week day labels based on cwstartweekon TABLEAU ALPHA(3;$Labels;7) ENUMERATION VERS TABLEAU("Jours_Abrégés";$Labels) $WkDayNum:=clnd_StartWeekOn Boucle ($Loop;1;7) $LabelPtr:=Pointeur vers("clnd_weekday"+chaine($loop)) $LabelPtr->:=$Labels{$WkDayNum} $WkDayNum:=$WkDayNum+1 Si ($WkDayNum>7) $WkDayNum:=1 Boucle ($Loop;1;7) $LabelPtr:=Pointeur vers("clnd_weekday"+chaine($loop)) $LabelPtr->:=$Labels{$WkDayNum} $WkDayNum:=$WkDayNum+1 Si ($WkDayNum>7) $WkDayNum:=1 et affecte les variables clnd_daytextx qui affichent le jour, elle active également les boutons btn_dayx qui permettent la sélection. `hide/show the correct calendar squares Boucle ($Loop;1;42) $ButtonPtr:=Pointeur vers("btn_day"+chaine($loop)) $DayTextPtr:=Pointeur vers("clnd_daytext"+chaine($loop)) $DayNum:=$Loop-clnd_Offset Si (($DayNum<=0) ($DayNum>$NumDays)) $DayText:="" $DayText:=Chaine($DayNum) 6 / 9

7 $DayTextPtr->:=$DayText Si ($DayText="") CHOIX VISIBLE($ButtonPtr->;Faux) CHOIX VISIBLE($ButtonPtr->;Vrai) elle affecte dynamiquement le contenu du popup clnd_year qui affiche les années, en limitant à 7 le nombre de valeurs, affichant les trois années qui précédent et les trois années qui suivent l'année de la date par défaut. `fill the year popup 3 years before and after the current year $Year:=Annee de(clnd_selectdate) Boucle ($Loop;1;7) clnd_year{$loop}:=$year-4+$loop clnd_year:=4 clnd_year{0}:=clnd_year{clnd_year} enfin elle sélectionne la date courante, en modifiant le style et la couleur de la variable clnd_daytextx qui affiche le jour de la date par défaut et positionne le bouton correspondant à 1 pour affecter la bonne date lors de la validation du dialogue. `select the current date clnd_lastindex:=jour de(clnd_selectdate)+clnd_offset $Object:=Pointeur vers("clnd_daytext"+chaine(clnd_lastindex)) $Button:=Pointeur vers("btn_day"+chaine(clnd_lastindex)) $Button->:=1 CHANGER STYLE($Object->;clnd_SelectStyle) $Color:=-(clnd_SelectColor+(256*745)) CHOIX COULEUR($Object->;$Color) Sélection Un clic sur le Popup clnd_month permet de sélectionner le mois de la date à affecter en exécutant la méthode objet associée. `Object Method: clnd_month `Resets the calendar based on the selected month Si (clnd_month{clnd_month}#clnd_month{0}) $Object:=Pointeur vers("clnd_daytext"+chaine(clnd_lastindex)) CHANGER STYLE($Object->;Normal ) $Color:=-(Bleu +(256*745)) 7 / 9

8 CHOIX COULEUR($Object->;$Color) $LastMonth:=Chercher dans tableau(clnd_month;clnd_month{0}) $AddMonths:=clnd_Month-$LastMonth clnd_selectdate:=ajouter a date(clnd_selectdate;0;$addmonths;0) CLND_Calendar_Set Cette méthode réinitialise la variable clnd_daytextx et le bouton btn_dayx du jour. En effet le changeant de mois modifiera la positon de ce jour dans le calendrier. Elle actualise la date par défaut et exécute à nouveau, la méthode CLND_Calendar_Set. Un clic sur le popup clnd_year exécute la méthode objet basée sur le même principe. `Object Method: clnd_year `Resets the calendar based on the selected year Si (clnd_year{clnd_year}#clnd_year{0}) $Object:=Pointeur vers("clnd_daytext"+chaine(clnd_lastindex)) CHANGER STYLE($Object->;Normal ) $Color:=-(Bleu +(256*745)) CHOIX COULEUR($Object->;$Color) $LastYear:=Chercher dans tableau(clnd_year;clnd_year{0}) $AddYears:=clnd_Year-$LastYear clnd_selectdate:=ajouter a date(clnd_selectdate;$addyears;0;0) CLND_Calendar_Set Un clic sur un bouton btn_day exécute la méthode CLND_Day_Select qui reçoit en paramètre un pointeur sur le bouton cliqué. `PM: CLND_Select C_ALPHA(100;$varName) C_POINTEUR($1;$ButtonPtr;$Object) C_ENTIER LONG($Color;$tableNum;$fieldNum;$OldLastIndex;$AddDays) $ButtonPtr:=$1 $Object:=Pointeur vers("clnd_daytext"+chaine(clnd_lastindex)) `get a pointer to the previous selected day CHANGER STYLE($Object->;Normal ) `reset the font style $Color:=-(Bleu +(256*745)) CHOIX COULEUR($Object->;$Color) `reset the font color RESOUDRE POINTEUR($ButtonPtr;$varName;$tableNum;$fieldNum) `get the name for the selected button $OldLastIndex:=clnd_LastIndex `index for previous selected clnd_lastindex:=num($varname) `index for selcted day $AddDays:=clnd_LastIndex-$OldLastIndex `days between old and new 8 / 9

9 clnd_selectdate:=ajouter a date(clnd_selectdate;0;0;$adddays) `set the selected date $Object:=Pointeur vers("clnd_daytext"+chaine(clnd_lastindex)) `get a pointer to new day text object CHANGER STYLE($Object->;clnd_SelectStyle) `set selected font style $Color:=-(clnd_SelectColor+(256*745)) CHOIX COULEUR($Object->;$Color) `set selected font color VALIDER Cette méthode commence par réinitialiser l'ancien bouton sélectionné, modifie la date par défaut en utilisant un Ajouter a date() après avoir calculé le nombre de jours qui séparent les deux boutons concernés, sélectionne le nouveau bouton et valide le formulaire. Cette validation affectera le champ date avec la date par défaut. La saisie des heures utilise le même principe. La gestion de l'horloge est plus simple parce qu'identique pour chacune des heures. Conclusion Cette technique, tout en laissant la possibilité de saisir les dates et les heures directement au clavier, permet une saisie par clic souris, qui dans certains cas peut faciliter la saisie. 9 / 9