home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / utility / mdial101 / manual.txt < prev    next >
Encoding:
Text File  |  1993-05-25  |  18.1 KB  |  371 lines

  1.                 MultiDialog (GEM-Dialogs in Windows)
  2.              =========================================
  3.  
  4. Copyright (c) 1992-93 Helmut Neukirchen
  5.                       Bönnersdyk 63
  6.                       W-4150 Krefeld
  7.                       Germany
  8.               e-mail: hn@pool.informatik.rwth-aachen.de
  9.  
  10. All rights reserved.
  11.  
  12.  
  13.  
  14.        Short english manual for MultiDialog >=V1.00 (25/10/93)
  15.       ---------------------------------------------------------
  16.  
  17.  
  18. Any commercial distribution is strictly prohibited! 
  19. (MultiDialog is a kind of Public Domain.)
  20.  
  21.  
  22.  
  23.  What does MultiDialog ?
  24. -------------------------
  25.  
  26. MultiDialog puts nearly any GEM-dialogbox into a GEM-Window. The 
  27. result is that you can access the menu-bar or other applications 
  28. while a dialog is running.
  29. This is especially VERY usefull for multitasking TOS-releases. 
  30. Though MultiDialog was designed to work with Atari's MultiTOS it 
  31. runs with all other TOS versions, too (i.e. TOS 1.0 - 4.xx and 
  32. multitasking enhancements like MultiGEM). (I hope :-)
  33.  
  34.  
  35.  
  36.  Installation
  37. --------------
  38.  
  39. MultiDialog can be installed (and configured) in several ways, 
  40. because it can be started as a GEM-Applikation, a GEM-Accessory 
  41. or as an AUTO-folder TOS-program (You just need to change the 
  42. extension of "MULTDIAL.*" from "PRG" to "ACC" - the program-file 
  43. is the same, it recognizes the way it's started!).
  44.  
  45. I suggest the following way of installation:
  46.  
  47. 1. Copy MULTDIAL.PRG to your AUTO-folder. 
  48.    (MULTDIAL.PRG will display a message when it's started 
  49.    via the AUTO-folder.)
  50.  
  51. If you have to configure MultiDialog very often:
  52.  
  53. 2. Copy MULTDIAL.ACC in your root-directory (or from whereever 
  54.    your ACC's are loaded.)
  55.  
  56. If you don't want to reset (in order to load the AUTO-Folder), 
  57. you can install MultiDialog just by starting MULTDIAL.PRG from 
  58. the Desktop, too.
  59.  
  60.  
  61.  
  62.  Configuring MultiDialog
  63. -------------------------
  64.  
  65. You can configure MultiDialog using a GEM-dialog. To do so you 
  66. should have MULTIDIAL.ACC installed and chose the menu-item 
  67. "MultiDialog" from the accessory-menu.
  68. (If MultiDialog wasn't installed or if it isn't installed as
  69. Accessory you will have to start MULTDIAL.PRG now to install or 
  70. to configure MultiDialog.)
  71.  
  72. A dialogbox should appear now.
  73.  
  74. - The first parameter you can change is "MultiDialog: [An|Aus]".
  75.   When " An " is selected this means that MultiDialog does 
  76.   interfere in the AES-calls to handle dialogs. When " Aus " is 
  77.   selected MultiDialog does not interfere in these calls (But 
  78.   still remains installed in memory and in several vector-chains.)
  79.  
  80.  
  81. The next items consider application specific configurations. 
  82.  
  83. - "FormCenter: [immer|Mitte|Ecke|Maus]" is the AES-routine which 
  84.   centers a dialogbox in the middle of the screen. Especially when 
  85.   using bigscreens it's annoying that a small dialogbox appears in 
  86.   the middle of the big screen, because you have to move the mouse 
  87.   quite far. MultiDialog can stop this. You can tell MultiDialog 
  88.   to put dialogboxes in the upper left corner (item " Ecke "), 
  89.   just at the mouse-pointers position (item " Maus ") or in the 
  90.   middle (items  " immer " or " Mitte "). The options " Mitte ", 
  91.   " Ecke " and " Maus " do remember the position a dialogbox had 
  92.   before, so you can move them at a position you like and they'll 
  93.   appear from now on at this position. If they are displayed for 
  94.   the first time they'll appear in the corner, the middle or at 
  95.   the mouse-position (just as you've configured). In contrast the 
  96.   item " immer " displays the dialogbox in the middle everytime 
  97.   (just as you are used to with the original GEM-routine).
  98.  
  99. If you've got any problems with dialogboxes which are not 
  100. completely visible try the " immer "-button, it's the most 
  101. compatible.
  102.  
  103. - The next line "Fenster bei: [Alert|FormDial|FormDo]" considers 
  104.   the circumstances to open a window for a dialogbox. 
  105.  
  106.   The first item " Alert " is used to decide whether alertboxes should
  107.   be displayed in windows or not. I suggest to activate this because
  108.   MultiDialog can handle alertboxes without any problems (well, in
  109.   fact you might get problems with the redraw...).
  110.  
  111.   The next two items refer to ordinary dialogboxes. " FormDial " is 
  112.   the most comfortable setting, but it works only with programs which 
  113.   use FormDial calls.
  114.  
  115.   The last item " FormDo " works with nearly any program, but it 
  116.   is not a very elegant way. A window is created at the beginning 
  117.   of a FormDo-call and deleted at the end of the FormDo call. 
  118.  
  119. There are two disadvantages: 
  120. In a lot of dialogs the user can scroll or display different 
  121. items (e.g. the "Install icon"-dialog of Atari's NEWDESK, but this
  122. is no good example as you will see later). In this case the window 
  123. MultiDialog creates is opened and closed every time a new item is 
  124. displayed. This slows down the dialog very much.
  125. The window MultiDialog creates is opened AFTER the dialog was 
  126. drawn. When createing the window the dialog might get painted by 
  127. other windows which are already visible. So the optic gets 
  128. destroyed.
  129.  
  130. - to handle this problem you can choose with "ObjcDraw bei 
  131.   FormDo: [Ja|Nein]" whether to repaint the dialog or not. " Ja " 
  132.   will repaint the dialog if the window was created by FormDo. This 
  133.   can slow down the dialog handle once again. Furthermore some 
  134.   programs do paint some graphics (e.g. images, color ranges) 
  135.   in the dialog which MultiDialog cannot repaint. For those 
  136.   programs you should choose " Nein ".
  137.  
  138. Because you won't have these problems with FormDial-dialogs
  139. this selection is only available if " FormDo " is selected at the 
  140. "Fenster bei:" line.
  141. (That's why I say "Fenster bei: [FormDial]" is more 
  142. comfortable, because this setting is absolutely compatible to the 
  143. original GEM-routines (with 1 exception - see Bugs/Restrictions)).
  144.  
  145.  
  146. Because some programs need other configurations than other 
  147. programs you can tell MultiDialog to take for specific 
  148. applications specific configurations - MultiDialog switches 
  149. automatically.
  150.  
  151. - The " Neu "-button is used to create new entries in the auto-
  152.   switch list. You can type in the name of the application in the 
  153.   edit field and MultiDialog takes the configuration you have 
  154.   chosen for that application (take the name which is displayed as 
  155.   window-name).
  156.  
  157. - With the up- and down-arrow you can scroll between the different 
  158.   applications which need a special configuration.
  159.  
  160. Most of the application work with the same standard configuration. 
  161. This configuration-entry has the name " Default "; MultiDialog 
  162. takes it if it couldn't find the application's name in the list 
  163. you've entered. 
  164.  
  165. - If you want to delete entries from the auto-switch list you have to 
  166.   use the " Löschen "-button which deletes the entry which is 
  167.   visible at the moment. (You can't delete the " Default " entry!)
  168.  
  169. - The " Sichern "-button saves the auto-switch list in your AUTO-folder 
  170.   in a file named "MULTDIAL.INF" which will be loaded next time if it is 
  171.   is found in your AUTO-folder.
  172.  
  173. - " OK " closes the dialogbox. " Abbruch " does the same but it 
  174.   doesn't update the changes you have made (this only works with 
  175.   the changes you've made on the entry which is visible now. 
  176.   Whenever you press the arrow-buttons the changes for that entry 
  177.   are updated at once.)
  178.  
  179.  
  180.  
  181.  How to handle MultiDialogs
  182. ----------------------------
  183.  
  184. Dialogs which profit of MultiDialog will appear in a window. This 
  185. window has the title " MultiDialog: <app_name> " (where <app_name> 
  186. is the name of the application). If MultiDialog recognizes an 
  187. accessory the app_name will be " Accessory " (using MultiTOS 
  188. you'll see the names of accessories, too). You can manipulate 
  189. the buttons of the concerning dialog as you're used to.
  190.  
  191. But furthermore you can now access the menu-bar (e.g. the accessories) 
  192. and the windows of other application which can do graphics in their 
  193. windows even while the dialog is active. 
  194. (Now that's wh`⇧נÆOî⇧üנäê⇧נÉ⇧üÇ´0¨ŒœÃ3ÉÉ⑥öåà╱à*47´øœ⓪<ôÉ1ãÃ⓪9ت2õ´⓪4´2À¨É397ÀÉ:42É6ØÃ:ûõ0¨gijIJג⑧\əXן]ə[ףê⇨B¥םəXם✓⑨ə\plays the dialog can't react to them because at this 
  195. time it is waiting for the dialog apëנé⇧נé⇦ז⇧נÇ⇩Y@⇧ת✓â!}ע¶üIJòחéβ
  196. p0Ã<É7´42¨⓪0õ´4ÃÃ⑦╱à╱à$ø⓪:5גH③¡ã╱íú⓪❎À!✓⇩&⇧>8①> ⇩ '>2    >9>b②f✓8◆>08╱◆>✓⇧>08⇨?IJא8╱⓪⇧>⇩!>╱!>&✓8╱!>⓪✓⇩!>╱!>⇩!28③>#>╱!>✓⇩&⇧?╱✓①?IJא" 8╱②!>✓①>⓪✓✓╱8③>╱⇧?2"╱    &✓8◆3    ⇨IJבH#>╱!>② ②8⇧>⓪ ①>⇩╱    >b②f⇧>8⇩'>✓⇧>8⇩!>⓪ ╱ 0╱ '?IJב2b ⇩⓪╱ ③>2     ⇨>b②f⇧3>✓⇧>08⇨ ◆>②!>✓◆9    IJבIJאH⇨>╱!>08⓪!>9>② ②8⇧>08╱╱①>b②f✓8◆>2◆>& ⓪⇨ ◆>08╱◆>b@②f⇧>9?IJא✓⇩&⇧>✓①>0② 8╱ '>╱⇧◆>2◆>✓⇧>08rictly prohibited! 
  197. (MultiDialog is a kind of Public Domain.)
  198.  
  199.  
  200.  
  201.  What does MultiDialog ?
  202. -------------------------
  203.  
  204. MultiDialog puts nearly any GEM-dialogbox into a GEM-Window. The 
  205. result is that you can access the menu-bar or other applications 
  206. while a dialog is running.
  207. This is especially VERY usefull for multitasking TOS-releases. 
  208. Though MultiDialog was designed to work with Atari's MultiTOS it 
  209. runs with all other TOS versions, too (i.e. TOS 1.0 - 4.xx and 
  210. multitasking enhancements like MultiGEM). (I hope :-)
  211.  
  212.  
  213.  
  214.  Installation
  215. --------------
  216.  
  217. MultiDialog can be installed (and configured) in several ways, 
  218. because it can be started as a GEM-Applikation, a GEM-Accessory 
  219. or as an AUTO-folder TOS-program (You just need to change the 
  220. extension of "MULTDIAL.*" from "PRG" to "ACC" - the program-file 
  221. is the same, it recognizes the way it's started!).
  222.  
  223. I suggest the following way of installation:
  224.  
  225. 1. Copy MULTDIAL.PRG to your AUTO-folder. 
  226.    (MULTDIAL.PRG will display a message when it's started 
  227.    via the AUTO-folder.)
  228.  
  229. If you have to configure MultiDialog very often:
  230.  
  231. 2. Copy MULTDIAL.ACC in your root-directory (or from whereever 
  232.    your ACC's are loaded.)
  233.  
  234. If you don't want to reset (in order to load the AUTO-Folder), 
  235. you can install MultiDialog just by starting MULTDIAL.PRG from 
  236. the Desktop, too.
  237.  
  238.  
  239.  
  240.  Configuring MultiDialog
  241. -------------------------
  242.  
  243. You can configure MultiDialog using a GEM-dialog. To do so you 
  244. should have MULTIDIAL.ACC installed and chose the menu-item 
  245. "MultiDialog" from the accessory-menu.
  246. (If MultiDialog wasn't installed or if it isn't installed as
  247. Accessory you will have to start MULTDIAL.PRG now to install or 
  248. to configure MultiDialog.)
  249.  
  250. A dialogbox should appear now.
  251.  
  252. - The first parameter you can change is "MultiDialog: [An|Aus]".
  253.   When " An " is selected this means that MultiDialog does 
  254.   interfere in the AES-calls to handle dialogs. When " Aus " is 
  255.   selected MultiDialog does not interfere in these calls (But 
  256.   still remains installed in memory and in several vector-chains.)
  257.  
  258.  
  259. The next items consider application specific configurations. 
  260.  
  261. - "FormCenter: [immer|Mitte|Ecke|Maus]" is the AES-routine which 
  262.   centers a dialogbox in the middle of the screen. Especially when 
  263.   using bigscreens it's annoying that a small dialogbox appears in 
  264.   the middle of the big screen, because you have to move the mouse 
  265.   quite far. MultiDialog can stop this. You can tell MultiDialog 
  266.   to put dialogboxes in the upper left corner (item " Ecke "), 
  267.   just at the mouse-pointers position (item " Maus ") or in the 
  268.   middle (items  " immer " or " Mitte "). The options " Mitte ", 
  269.   " Ecke " and " Maus " do remember the position a dialogbox had 
  270.   before, so you can move them at a position you like and they'll 
  271.   appear from now on at this position. If they are displayed for 
  272.   the first time they'll appear in the corner, the middle or at 
  273.   the mouse-position (just as you've configured). In contrast the 
  274.   item " immer " displays the dialogbox in the middle everytime 
  275.   (just as you are used to with the original GEM-routine).
  276.  
  277. If you've got any problems with dialogboxes which are not 
  278. completely visible try the " immer "-button, it's the most 
  279. compatible.
  280.  
  281. - The next line "Fenster bei: [Alert|FormDial|FormDo]" considers 
  282.   the circumstances to open a window for a dialogbox. 
  283.  
  284.   The first item " Alert " is used to decide whether alertboxes should
  285.   be displayed in windows or not. I suggest to activate this because
  286.   MultiDialog can handle alertboxes without any problems (well, in
  287.   fact you might get problems with the redraw...).
  288.  
  289.   The next two items refer to ordinary dialogboxes. " FormDial " is 
  290.   the most comfortable setting, but it works only with programs which 
  291.   use FormDial calls.
  292.  
  293.   The last item " FormDo " works with nearly any program, but it 
  294.   is not a very elegant way. A window is created at the beginning 
  295.   of a FormDo-call and deleted at the end of the FormDo call. 
  296.  
  297. There are two disadvantages: 
  298. In a lot of dialogs the user can scroll or display different 
  299. items (e.g. the "Install icon"-dialog of Atari's NEWDESK, but this
  300. is no good example as you will see later). In this case the window 
  301. MultiDialog creates is opened and closed every time a new item is 
  302. displayed. This slows down the dialog very much.
  303. The window MultiDialog creates is opened AFTER the dialog was 
  304. drawn. When createing the window the dialog might get painted by 
  305. other windows which are already visible. So the optic gets 
  306. destroyed.
  307.  
  308. - to handle this problem you can choose with "ObjcDraw bei 
  309.   FormDo: [Ja|Nein]" whether to repaint the dialog or not. " Ja " 
  310.   will repaint the dialog if the window was created by FormDo. This 
  311.   can slow down the dialog handle once again. Furthermore some 
  312.   programs do paint some graphics (e.g. images, color ranges) 
  313.   in the dialog which MultiDialog cannot repaint. For those 
  314.   programs you should choose " Nein ".
  315.  
  316. Because you won't have these problems with FormDial-dialogs
  317. this selection is only available if " FormDo " is selected at the 
  318. "Fenster bei:" line.
  319. (That's why I say "Fenster bei: [FormDial]" is more 
  320. comfortable, because this setting is absolutely compatible to the 
  321. original GEM-routines (with 1 exception - see Bugs/Restrictions)).
  322.  
  323.  
  324. Because some programs need other configurations than other 
  325. programs you can tell MultiDialog to take for specific 
  326. applications specific configurations - MultiDialog switches 
  327. automatically.
  328.  
  329. - The " Neu "-button is used to create new entries in the auto-
  330.   switch list. You can type in the name of the application in the 
  331.   edit field and MultiDialog takes the configuration you have 
  332.   chosen for that application (take the name which is displayed as 
  333.   window-name).
  334.  
  335. - With the up- and down-arrow you can scroll between the different 
  336.   applications which need a special configuration.
  337.  
  338. Most of the application work with the same standard configuration. 
  339. This configuration-entry has the name " Default "; MultiDialog 
  340. takes it if it couldn't find the application's name in the list 
  341. you've entered. 
  342.  
  343. - If you want to delete entries from the auto-switch list you have to 
  344.   use the " Löschen "-button which deletes the entry which is 
  345.   visible at the moment. (You can't delete the " Default " entry!)
  346.  
  347. - The " Sichern "-button saves the auto-switch list in your AUTO-folder 
  348.   in a file named "MULTDIAL.INF" which will be loaded next time if it is 
  349.   is found in your AUTO-folder.
  350.  
  351. - " OK " closes the dialogbox. " Abbruch " does the same but it 
  352.   doesn't update the changes you have made (this only works with 
  353.   the changes you've made on the entry which is visible now. 
  354.   Whenever you press the arrow-buttons the changes for that entry 
  355.   are updated at once.)
  356.  
  357.  
  358.  
  359.  How to handle MultiDialogs
  360. ----------------------------
  361.  
  362. Dialogs which profit of MultiDialog will appear in a window. This 
  363. window has the title " MultiDialog: <app_name> " (where <app_name> 
  364. is the name of the application). If MultiDialog recognizes an 
  365. accessory the app_name will be " Accessory " (using MultiTOS 
  366. you'll see the names of accessories, too). You can manipulate 
  367. the buttons of the concerning dialog as you're used to.
  368.  
  369. But furthermore you can now access the menu-bar (e.g. the accessories) 
  370. and the windows of other application which can do graphics in their 
  371. windows even while the dialog is active. 
  372. (Now that's wh`⇧נÆOî⇧üנäê⇧נÉ⇧üÇ´0¨ŒœÃ3ÉÉ⑥öåà╱à*47´øœ⓪<ôÉ1ãÃ⓪9ت2õ´⓪4´2À¨É397ÀÉ:42É6ØÃ:ûõ0¨gijIJג⑧\əXן]ə[ףê⇨B¥םəXם✓⑨ə\