home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / filemanager / blackhole_1 / !ToolBar / !Help < prev    next >
Text File  |  1995-05-15  |  9KB  |  190 lines
  1.    
  2.                                A Desktop Tool Bar
  3.                                ==================
  4.  
  5. So what does it do then?
  6. ------------------------
  7.  
  8. Many applications (e.g. Draw) have a tool bar - a small window containing icons
  9. which perform some action (e.g. Select Mode, Text Mode etc.) when clicked on.
  10. Wouldn't it be nice if all applications could have this? Well now they can.
  11. ToolBar provides this facility in a 'Smart' fashion. It is user-configurable
  12. (see later) and will provide a tool bar relevant to whichever application
  13. currently has the caret. The tool bar will change if the owner of the caret
  14. changes. And it's fully compatible with !Help. What more could you ask?
  15. Don't answer that. It's not THAT powerful.
  16.  
  17. Running ToolBar installs an icon on the iconbar. Clicking SELECT over this icon
  18. opens the ToolBar window, the title bar of which will display which application
  19. it is currently showing tools for. If no window currently has the caret, then
  20. ToolBar will use its 'Desktop' icons, which have the same functions as the F12
  21. key (i.e. command line, bring iconbar to front, task window, and shutdown). If
  22. the application which owns the caret is not known to ToolBar, then it will
  23. display its 'Global' icons - icons which correspond to almost all applications,
  24. i.e save,find,cut,copy,paste. These should work with most applications, but 
  25. there may be cases when the outcome is unpredictable. Don't blame me if your
  26. wordprocessor attempts to make potato pie every time you click on Tool Bar.
  27. I think this scenario is very unlikely, however.
  28.  
  29. Go on, tell us how it works.
  30. ----------------------------
  31.  
  32. It's dead simple. When you click on an icon, ToolBar issues forth a command
  33. equivalent to the 'Hot Key' for that command. E.g. if you click on the 'Save'
  34. icon, ToolBar will 'press' F3, which for most applications pops up a 'Save As'
  35. box. Similarly, 'Find' is F4, cut is ^X, copy is ^C, and paste is ^V.
  36.  
  37. So, how do you configure it?
  38. ----------------------------
  39.  
  40. Obviously, ToolBar can only be configured to issue commands when there is a
  41. 'Hot Key' for that command. To set up ToolBar so that it knows about an 
  42. application, you have to edit the file 'Keys' contained inside !ToolBar (use
  43. !Edit or similar). The format is as follows:
  44.  
  45. <Appname>
  46. sprite,key
  47. Helptext
  48. sprite1,key1
  49. Helptext1
  50. Stop
  51.  
  52. <Appname>
  53. etc.
  54. Stop
  55.  
  56. End
  57.  
  58. where <Appname> is replaced by the name of the application as it appears in the
  59. Task Manager window. You should replace 'sprite' with the name of a sprite to
  60. use for the button. The sprites are contained in the file 'Tools' and you can
  61. either use one of these or define your own. If you define your own, make sure
  62. you save it in the 'Tools' file. Helptext is a line of text which will
  63. be passed to the interactive Help (!Help) application if it is running when the
  64. pointer is over the icon. The message should be short and informative. The
  65. program will prefix whatever you put with 'Click SELECT to '.
  66.  
  67. The key definition has a strict order:
  68.  
  69. Shift-Ctrl is specified as ⇧^ (use!Chars to get the arrow)
  70. Function keys start with F
  71. Shift is specified as ⇧
  72. Ctrl is specified as ^
  73. You can only specify Shift-Ctrl in conjunction with a function key or 'Special
  74. Key' (e.g. Print, Page Up, etc). For special keys, you must enter them using
  75. the same case as appears on the key - e.g. Page Down MUST have the initial
  76. capital letters - 'page Down', 'PAGE DOWN' etc. are unacceptable.
  77.  
  78. So, to specify Shift-F3 you would write ⇧F3
  79. To specify Ctrl-X you would write ^X. The letter must be capitalised (i.e
  80.                                       ^x will not do.)
  81.  
  82. Note that you do not need to specify 'Hot keys' - any ASCII character can be
  83. specified - eg open quotes, accented characters, etc.
  84.  
  85. If the program encounters a key definition which it cannot understand, that
  86. definition will be ignored.
  87.  
  88. Stop MUST ALWAYS BE FOLLOWED BY A BLANK LINE!!!!!
  89. There must be NO OTHER SPACES OR BLANK LINES in the file and it
  90. MUST END WITH End.
  91.  
  92. The first two definitions (Desktop and Global) should not be removed or have
  93. anything put in front of them unless you want different defaults.
  94.  
  95. Currently you can define up to 21 keys for up to 11 different applications.
  96. If there are more than 11 applications defined, the surplus will be ignored. Too
  97. many key definitions will cause a fatal error.
  98.  
  99. The Icon Bar Menu.
  100. ------------------
  101.  
  102. Also accessible with 'Menu' over the ToolBar window.
  103.  
  104. Four entries : Info and Quit are the usual.
  105.  
  106. Follow Caret allows you to stop ToolBar changing whenever the caret moves.
  107.  
  108. Moving right off Applications presents a list of all currently known
  109. applications. Selecting one will cause the ToolBar window to change to that
  110. set of icons, and Follow Caret will be turned off.
  111.  
  112.  
  113.                         © Fat German Productions 1993
  114.  
  115. Disclaimer:
  116. ===========
  117.  
  118. This program is supplied 'as is' with no guarantee of its suitability for any
  119. purpose. I will not be held responsible for it or anything that may happen due
  120. to its use or misuse. 'Use' in this instance is defined as running the software,
  121. this being accomplished by the accepted method of double-clicking, meaning 
  122. pressing the left mouse button twice in succession over the program's icon or
  123. the icon for its !Run file so as to begin the process of copying the program
  124. from the permanent storage medium on which it is kept into the temporary
  125. storage provided by the random access memory of the computer and thereby
  126. causing the computer to begin to execute the instructions contained within the
  127. part of the program known as the filling which is covered by the topping and
  128. then the custard.
  129. Running the program is taken to be acceptance of this condition. No other
  130. conditions will be imposed on any users, subject to the condition that their
  131. computing equipment is in a suitable condition to properly run the software,
  132. which has been conditionally tested under a variety of conditions to ensure that
  133. it does not crash on any condition. Or something like that.
  134. This software is perfect. There is nothing whatsoever wrong with it. Any
  135. additional features not documented in this file are purely the product of a
  136. deranged mind and I would recommend that you see a psychiatrist. Also talk to
  137. him and make sure he can see you, otherwise he'll think he's gone mad.
  138. Or something.
  139. -----------------------------------------------------------------------------
  140.  
  141. Public Domain Notice:
  142. =====================
  143.  
  144. Tool Bar is phase 2 of Fat German Productions' plan for world domination. Phase
  145. 1 was Black Hole 2, which was brilliant and perfect. Phase 3 has yet to be 
  146. finalised but will probably involve annexing a small area of memory.
  147. This software is released by assent of the Fat German and the Great Green
  148. Gollywog. His minions would have nothing to do with this, as they complained it
  149. wasn't violent enough. It may be freely copied and used, as long as the 
  150. following conditions are met:
  151.  
  152. a) That this notice is distributed unchanged with every copy.
  153. b) That the application is supplied with unchanged versions of all files.
  154.    (If you design any nice new sprites or set up any new applications
  155.     definitions, let me know and I'll include them in future releases.)
  156. c) No charge is made for the distribution. Public domain libraries may make
  157.    a small charge to cover distribution costs. It is highly unethical, not
  158.    to mention dishonest to make a charge for software which programmers
  159.    have intended to be freely distributed, especially if none of that profit
  160.    finds its way to the programmer.
  161. d) Everybody gets down and boogies.
  162.  
  163. All copyright is reserved. You may not use any part of this application in
  164. any project which is to be sold for profit without my express permission
  165. in writing.
  166.  
  167. If you wish to use pieces of my code in your own pd programs then please feel
  168. free to do so, provided these programs are not intented for sale.
  169. I say this mainly because my telling you not to do so would not stop you, but
  170. also becasue I learned programming by nicking and splicing bits of other
  171. people's programs, so why shouldn't you?
  172.  
  173. If you do use my code, a credit would be nice. Money would be even better.
  174.  
  175. If anybody out there feels like designing some really pretty icons for the
  176. tools, I'd be only too glad to include them in future releases. Full credit
  177. will be given. (My artistic talent is confined to beautifully written BASIC,
  178. though this is by choice and does not mean I can't draw. I could do it if I 
  179. tried. Wibble.)
  180.  
  181. © 1993 Mark Greenwood (aka Fat German)
  182.  
  183. Fat German Productions,
  184. 122 Miswell Lane,
  185. Tring,
  186. Herts. HP23 4EU
  187. England
  188.  
  189. email : mgreenwo@madge.com
  190.