home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / bbs / ff792.lha / FF792 / DRAGIT / DragIt.doc.franíÂis < prev    next >
Text File  |  1993-01-08  |  18KB  |  403 lines
  1.  
  2.  
  3.  
  4.  
  5.               ######                                ######
  6.               #######                               ######
  7.               ##    ##                                ##
  8.               ##    ## ## ###   ######   #####        ##   ######
  9.               ##    ## #######  ####### #######       ##   ######
  10.               ##    ## ###   ##      ## ##   ##       ##     ##
  11.               ##    ## ##        ###### ####### ####  ##     ##
  12.               ##    ## ##       #######  ###### ####  ##     ##
  13.               ##    ## ##       ##   ##      ##       ##     ##
  14.               #######  ##       ####### #######     ######   ##
  15.               ######   ##        ###### #######     ######   ##
  16.  
  17.  
  18.  
  19.                          DragIt 2.01 by Steve Lemieux
  20.  
  21.       © Copyright 1992, SilverBox Software, All rights reserved, Freeware
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. Introduction :
  31. --------------
  32.  
  33.     Le but de ce programme est de permettre de déplacer et de changer
  34. la dimension d'une fenêtre sans aucune contrainte. Il est possible de
  35. modifier une fenêtre à partir de n'importe quel point de la fenêtre et ce même
  36. si la fenêtre est en partie cacher ou si elle est inactive. On peut aussi
  37. configurer une ou plusieurs touches accompagnant le bouton de la souris
  38. qui active le programme. Le bouton est aussi configuration et les souris
  39. 3 boutons sont supportés.
  40.  
  41.     DragIt ne fonctionne que sous AmigaOS 2.0 et plus. Il supporte aussi
  42. les nouvelles spécificités du système 2.1 (ou 3.0) en particulier pour le
  43. support des différents langages (locale.library) et un nouveau modèle de
  44. préférence.
  45.  
  46.     Ce programme est composé de plusieurs modules. Le programme principal
  47. DragIt qui est autonome et optimisé dans le but d'être le plus petit et
  48. prendre le moins de mémoire possible (environ 10k). Une autre partie est
  49. composée du préférence Drag. Il permet de changer tous les configurations
  50. sans avoir à toucher au programme principal.
  51.  
  52.     L'archive complet comprend les fichiers suivant :
  53.  
  54.         Drag              : Préférence
  55.         DragIt            : Programme principal
  56.         Drag.h            : Information sur le format IFF du fichier
  57.                             de configuration Drag.prefs
  58.         Drag.doc          : Documentation anglaise
  59.         Drag.doc.français : Documentation française
  60.         DragPref.catalog  : Fichiers contenant tous les chaînes de
  61.                             caractère du préférence en français
  62.         DragPref.cd       : Fichier d'aide pour la création de catalog
  63.                             spécifique à votre langage
  64.  
  65. Installation :
  66. --------------
  67.  
  68.     La façon la plus simple d'installer DragIt est de déplacer l'icône
  69. dans le répertoire 'WBStartup' du workbench.
  70.  
  71.     On peut aussi l'exécuter en plaçant le programme dans le répertoire C:
  72. et d'ajouter à la 'Startup-Sequence' normalement à la suite du programme
  73. IPref :
  74.  
  75.         run >nil: DragIt
  76.  
  77.     Si l'on veut une exécution immédiate, on peut à tout moment taper le
  78. nom du programme dans le CLI ou double-clicker l'icône du workbench.
  79.  
  80.     DragIt ne peut être exécuté 2 fois en même temps. Dans ce cas, DragIt
  81. quittera tout simplement.
  82.  
  83.     Le préférence doit être placé dans le même répertoire que les autres
  84. préférences du système normalement SYS:Prefs.
  85.  
  86.     Si vous possédez la locale.library (ce qui n'est pas obligatoire), vous
  87. devez placer les 2 fichiers DragPref.catalog dans le répertoire correspondant
  88. à la langue désirée. Si aucun fichier catalog est utilisé, l'anglais est
  89. utilisé par défaut. Par exemple, copier le fichier DragPref.catalog français
  90. dans le répertoire LOCALE:calalogs/français.
  91.  
  92. Préférence :
  93. ------------
  94.  
  95.  
  96.     Le préférence est utilisé pour configurer entièrement DragIt. La façon de
  97. procéder est la même que dans toutes les autres préférences du système, il est
  98. donc nécessaire de ce référer au manuel d'instruction de Amiga OS pour plus de
  99. détails sur le fonctionnement des préférences.
  100.  
  101.     Options de configuration disponible :
  102.  
  103.         Bouton souris : Permet de choisir le bouton qui permet d'activer DragIt
  104.                         en mode déplacement ou dimension.
  105.  
  106.         Zone : Sélection de la zone permettant de configurer la dimension des
  107.                cadres.
  108.  
  109.         Option déplacement : Active le mode permettant de déplacer une fenêtre
  110.                              en utilisant le bouton et les touches configurées.
  111.  
  112.         Option dimension : Active le mode permettant de changer la dimension
  113.                            d'une fenêtre en utilisant le bouton et les touches
  114.                            configurées et ce, dans la zone déterminée.
  115.  
  116.         Option coins : Active une façon différente gérer le changement de
  117.                        dimension des fenêtres.
  118.  
  119.             Sans l'option des coins : Les bordures gauche-haut et droite-bas
  120.                                       permettent des déplacements sur les 2 axes
  121.                                       dans les mêmes directions.
  122.  
  123.                 +------------------------------------------+
  124.                 |       Zone de dimension gauche-haut      |
  125.                 |  +------------------------------------+--+
  126.                 |  |                                    |  |
  127.                 |  |                                    |  |
  128.                 |  |        Zone de déplacement         |  |
  129.                 |  |                                    |  |
  130.                 |  |                                    |  |
  131.                 |  |                                    |  |
  132.                 +--+------------------------------------+  |
  133.                 |       Zone de dimension droite-bas       |
  134.                 +------------------------------------------+
  135.  
  136.             Avec l'option des coins : Les coins permettent des changements de
  137.                                       dimension selon les 2 axes alors que les
  138.                                       zones au centre de la bordure permettent
  139.                                       des changements en parallèles.
  140.  
  141.                 +-----+------------------------------+-----+
  142.                 |     |                              |     |
  143.                 |  +--+------------------------------+--+  |
  144.                 |  |                                    |  |
  145.                 +--+                                    +--+
  146.                 |  |        Zone de déplacement         |  |
  147.                 |  |                                    |  |
  148.                 +--+                                    +--+
  149.                 |  |                                    |  |
  150.                 |  +--+------------------------------+--+  |
  151.                 |     |Zone de dimension en parallèle|     |
  152.                 +-----+------------------------------+-----+
  153.                    ^
  154.                    |
  155.                    +---- Zone de déplacement sur 2 axes
  156.  
  157.         Priorité programme : Permet de changer la priorité de DragIt dans le but
  158.                              d'utiliser plus ou moins de temps système. Une
  159.                              priorité de -127 à 127 peut être utilisé mais pour
  160.                              ne pas entrer en conflit avec le système
  161.                              d'exploitation, des valeurs entre -5 et 5 sont
  162.                              préférable.
  163.  
  164.         Priorité handler : Permet de changer la priorité du handler utilisé par
  165.                            DragIt pour intercepter les événements de la souris.
  166.                            Une priorité de -127 à 127 peut être utilisé mais
  167.                            pour ne pas entrer en conflit avec l'intuition, de
  168.                            plus de 50 sont préférables.
  169.  
  170.         Touches déplacement : Permet de sélectionner une ou plusieur touches
  171.                               permettant d'effectuer le déplacement. Les touches
  172.                               suivant peuvent être utilisé : LSHIFT, RSHIFT,
  173.                               CONTROL, LALT, RALT, LCOMMAND et RCOMMAND. Si
  174.                               plusieurs choix est entré, on utilise le caractère
  175.                               '|' comme séparateur. Il est obligatoire d'entrer
  176.                               une touche sauf dans le cas où on utilise le
  177.                               bouton du centre de la souris où l'on peut
  178.                               indiquer NONE.
  179.  
  180.         Touches dimension : Permet de sélectionner une ou plusieurs touches
  181.                             permettant d'effectuer le changement de dimension de
  182.                             la fenêtre. Les touches se configure de la même
  183.                             façon que pour les touches de déplacement. Il est
  184.                             possible d'utiliser les mêmes touches pour la
  185.                             dimension et le déplacement.
  186.  
  187.         Boutons des bordures : On change la dimension du cadre de sélection des
  188.                                dimension/déplacement en appuyant sur le bouton
  189.                                de la souris et en bougeant de gauche à droite.
  190.                                On peut aussi appuyer rapidement sur le bouton
  191.                                en étant sur la partie gauche ou droite du gadget
  192.                                pour obtenir un incrémentation ou décrémentation
  193.                                de 1. Des valeurs entre 1 et 99 peuvent être
  194.                                sélectionné. En appuyant sur la touche Shift de
  195.                                gauche on peut permettre au 4 gadgets affichés
  196.                                en même temps d'avoir la même valeur.
  197.  
  198.     Menu disponible :
  199.  
  200.         Projet :
  201.  
  202.             Ouvrir : Charge les informations d'un fichier de préférence sauvé
  203.                      ultérieurement. Lorsque l'option est sélectionnée, un
  204.                      requester de fichier est affiché.
  205.  
  206.             Sauver en... : Permet de sauver sous un autre nom les préférences
  207.                            présentement sélectionnées.
  208.  
  209.             Quitter : Quitter le préférence.
  210.  
  211.         Edition :
  212.  
  213.             Valeurs par défaut : Sélectionne les valeurs par défaut attribué
  214.                                  au préférence.
  215.  
  216.             Dernières valeurs sauvées : Sélectionne les dernières valeurs
  217.                                         sauvées sur le disque.
  218.  
  219.             Valeurs initiales : Sélectionne les valeurs affichées lorsque le
  220.                                 préférence fut ouvert.
  221.  
  222.         Options :
  223.  
  224.             Créer icônes? : Permet la sauvegarde automatique d'une icône lorsque
  225.                             l'on sauve les options à l'aide de Sauver en... dans
  226.                             le menu Projet.
  227.  
  228.     Bouton d'action disponible :
  229.  
  230.         Sauver : Sauve sur le disque et rend permanentes les options
  231.                  sélectionnées. Ces options deviennent active immédiatement et
  232.                  elle demeure même lorsque l'on repart la machine.
  233.  
  234.         Utiliser : Active les options immédiatement mais de façon non
  235.                    permanente. Les changements sont perdus lorsque l'on repart
  236.                    la machine.
  237.  
  238.         Annuler : Désactive tous changements fait au préférence. Les options
  239.                   deviennent les mêmes que celles précédent l'ouverture du
  240.                   préférence.
  241.  
  242.     Options de l'icône disponible :
  243.  
  244.         Edit : Permet l'ouverture de la fenêtre dans le but d'éditer les
  245.                préférences avec celle contenue dans le fichier associé à
  246.                l'icône.
  247.  
  248.         Save : Sauve et rend permanent les configurations contenues dans le
  249.                fichier associé à l'icône.
  250.  
  251.         Use : Active les options mais de façon non permanente à partir des
  252.               configurations contenue dans le fichier associé à l'icône.
  253.  
  254.         CreateIcons : Permet la sauvegarde automatique d'une icône lorsque
  255.                       l'on sauve les options à l'aide de Sauver en... dans
  256.                       le menu Projet.
  257.  
  258.         PubScreen : Permet de choisir un écran public sur laquelle le
  259.                     préférence doit s'ouvrir. Le nom spécifier doit être
  260.                     exactement semblable pour que l'écran soit trouvé. Si
  261.                     l'écran n'est pas trouvé, la fenêtre est ouverte sur
  262.                     l'écran par défaut normalement le Workbench.
  263.  
  264. Pour enlever DragIt :
  265. ---------------------
  266.  
  267.     Lorsque le programme est exécuté dans le workbench, il faut utiliser
  268. les commodités (voir plus bas) pour quitter.
  269.  
  270.     Dans le CLI, si la fenêtre où DragIt a été exécuté est toujours ouverte,
  271. on quitte en appuyant sur CTRL-C. Lorsque la fenêtre a été fermée, on peut
  272. taper la commande 'Status' pour obtenir le numéro du processus et
  273. taper ensuite :
  274.  
  275.         break <no du processus> c
  276.  
  277.     Lorsque DragIt est exécuté à partir du CLI, les commodités sont
  278. toujours valides. Il est donc possible de quitter aussi de cette façon.
  279.  
  280.     Une autre façon de désactiver est d'enlever les options de déplacement et
  281. de dimension dans le préférence. Cependant, dans ce cas, la mémoire
  282. utilisé par DragIt n'est pas libérée puisque d'exécution du programme
  283. se poursuit toujours. L'option enable/disable des commodités fonctionne
  284. de la même manière.
  285.  
  286. Commodités :
  287. ------------
  288.  
  289.     Les commodités permettent un contrôle total du programme à partir
  290. du programme 'Exchange' fournis avec le workbench 2.0. En exécutant ce
  291. programme et en appuyant sur DragIt on peut utiliser les boutons suivants :
  292.  
  293.         ENABLE  : Active DragIt
  294.         DISABLE : Désactive DragIt mais sans quitter
  295.         KILL    : Désactive DragIt et quitte
  296.  
  297.     Le préférence et les commodités sont traité distinctement. Si on
  298. désactive d'une façon on doit le réactiver de la même manière. Il est
  299. donc impossible de désactivé DragIt avec les commodités et de réactiver
  300. avec le préférence.
  301.  
  302. Configuration :
  303. ---------------
  304.  
  305.     Les deux modes de configuration suivant sont utilisés à titre de
  306. compatibilité avec les anciennes versions du programme. Ils permettent
  307. un contrôle moins élaborer que le préférence. Cependant, il est parfois
  308. préférable d'utiliser ce mode de configuration dans le but d'économiser
  309. de l'espace sur disque. Si ce mode de configuration est utilisé, le fichier de
  310. configuration Drag.prefs ne sera pas chargé et seul les options demandé seront
  311. utilisé. Le préférence peut quand même être utilisé, dans ce cas, si l'on
  312. modifie une configuration du CLI ou du workbench et que DragIt est activé,
  313. le préférence aura priorité.
  314.  
  315.     Le format du CLI est le suivant :
  316.  
  317.         DragIt FRAMESIZE/N,PRIORITY/N,LSHIFT/S,RSHIFT/S,CONTROL/S,LALT/S,
  318.                RALT/S,LCOMMAND/S,RCOMMAND/S
  319.  
  320.     FRAMESIZE définie la largeur de la bordure permettant le changement de
  321. dimension de la fenêtre. Si aucune valeur n'est spécifiée, une largeur de
  322. quatre pixels est utilisée par défaut. On peut aussi annuler cette option
  323. en spécifiant une largeur de cadre de zéro.
  324.  
  325.     PRIORITY est utilisé pour spécifier la priorité du 'input handler'. La
  326. valeur par défaut est 125. Il est utile de changer cette valeur seulement si
  327. une application de plus haute priorité cause des problèmes à DragIt. Ne jamais
  328. utiliser une valeur inférieure à 50. Un problème peut cependant survenir
  329. si un accélérateur de souris est installé. Si la souris est bougée trop vite,
  330. le pointeur ne s'arrêtera pas à l'endroit prévu. Ce problème n'est cependant
  331. pas énorme et il peut être corrigé en augmentant la priorité du 'handler' de
  332. l'accélérateur de souris supérieure au 'handler' de DragIt.
  333.  
  334.     Les qualificatifs des touches sont utilisés pour configurer les touches
  335. qui seront utilisées pour activer DragIt lorsque l'on appuie sur le bouton
  336. gauche de la souris.
  337.  
  338.     On peut combiner les touches. Par exemple :
  339.  
  340.         DragIt lshift control
  341.  
  342.     Dans ce cas, Il faut appuyer sur les 2 touches et le bouton pour activer
  343. le déplacement.
  344.  
  345.     Dans l'icône du WorkBench :
  346.  
  347.     On peut aussi placer les paramètres dans l'icône à partir de l'option
  348. 'information' du workbench. Les fonctions des commandes sont les mêmes
  349. mais la syntaxe est différente. On sépare les différentes touches par le
  350. caractère '|'. Par exemple :
  351.  
  352.     framesize=6
  353.     priority=128
  354.     qualifier=lalt
  355.     qualifier=rcommand|lcommand
  356.  
  357.     Si aucune définition de touche n'est spécifiée, CONTROL est assumé
  358. par défaut.
  359.  
  360. Pour rejoindre l'auteur :
  361. -------------------------
  362.  
  363. Steve Lemieux
  364. 3330 France-Prime #312
  365. Ste-Foy, Québec, Canada
  366. G1W 4V2
  367.  
  368. BIX    : slemieux
  369. EMail  : slemieux@nyx.cs.du.edu
  370.  
  371. Versions ultérieures :
  372. ----------------------
  373.  
  374. Version 1.00 : - Première version publique
  375.  
  376. Version 1.01 : - Correction d'un bug lorsque utilisé dans écran 640x200
  377.  
  378. Version 2.00 : - La touche CONTROL est maintenant utilisée par défaut
  379.                - Le pointeur de souris est arrêté lorsque le cadre ne peut
  380.                  plus bouger
  381.                - On peut changer la grosseur de la fenêtre en appuyant sur
  382.                  son cadre
  383.                - Ajout de l'option FRAMESIZE pour spécifier la largeur du cadre
  384.                - Correction du bug des déplacements dans les écrans virtuels
  385.                - Ajout d'un préférence
  386.                - Support de locale.library (Français et Anglais)
  387.                - Compatibilité totale avec WB 2.1 (et 3.0). DragIt reste
  388.                  compatible 2.0
  389.                - Configuration du bouton et des touches différentes pour le
  390.                  déplacement et la dimension
  391.                - Spécification de tous les côtés du cadre de déplacement et
  392.                  de dimension
  393.                - Reconnaissance du fichier IFF ENV:drag.prefs
  394.                - Option pour déplacement des coins différemment du reste du
  395.                  cadre
  396.                - Support des souris à 3 boutons
  397.  
  398. Version 2.01 : - Support des menus du Workbench 3.0
  399.                - Correction du bug des écrans DoublePAL/DoubleNTSC
  400.                - Correction du conflit avec MagicMenu (Merci à Eric Gailloux)
  401.                - Correction du deadlock lorsque l'on ouvre/ferme une fenêtre
  402.                  pendant un déplacement (Merci à Franz Schwarz)
  403.