home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / e / extrabar / !Help next >
Text File  |  1997-02-10  |  18KB  |  457 lines
  1. ExtraBar Version 0.77
  2. =====================
  3. Purpose
  4. =======
  5. Extrabar is one of those desktop utilies that you will either hate or decide
  6. you can't live life with out it. It has been designed to ease the use of the
  7. desktop. It does this by creating a new tool bar for the desktop, which can
  8. have buttons created on it.
  9.  
  10. These buttons can do a number of things;
  11.  
  12.   • Opening a 'Filer_Menu' which shows the contents
  13.     of a directory and leads to it's sub-
  14.     directories.
  15.   • 'Insert_text' to enter frequently used text in
  16.     to an application.
  17.   • 'Emulate_Key' presses for use with applications
  18.     that do not have tool bars.
  19.   • Move the caret.
  20.   • Issue any star command.
  21.   • Dynamic buttons. These can have a system variable, the current time,
  22.     amount of free memory or freespace on a disc.
  23.  
  24. and it also features;
  25.  
  26.   • Easy save. Just drag a file from the Save As
  27.     window of any application on to the ExtraBar and
  28.     it will get saved in to a central directory just
  29.     like with a normal directory. So no more messing
  30.     around opening filer windows.
  31.  
  32. It can also issue multiple commands so that with one mouse click you could
  33. run your internet software, mail reader as well as a desktop publiser and
  34. graphics program. Why is, of course, another question :-)
  35.  
  36. Connected
  37. =========
  38. If you have seen the latest pre-christmas Intel adverts about 'connectted'
  39. software and are wondering what this has to do Acorn, well.
  40.  
  41.              ***** THIS IS A CONNECTED APPLICATION *****
  42.  
  43. In the Info window is a button, containing the words 'WWW home
  44. page',clicking on that will take you straight to the Extrabar home page
  45. where upgrades are placed when they become available. Upgrading is now much
  46. easier than before.
  47.  
  48. This is only available is you have a supporting web browser loaded.
  49. Currently that includes Webite, Fresco and ArcWeb.
  50.  
  51. Older versions
  52. ==============
  53. Version 0.40 of Extrabar contained a small buglet. When a button was setup
  54. the wrong bits of the data flag where setup. So when a button file was
  55. loaded in to a older or new version of Extrabar it would look different. The
  56. horizontal gaps became vertical gaps. This has been fixed in this version of
  57. Extrabar however it could mean that some of you tool bars could look
  58. different to how you expected them.
  59.  
  60. Using
  61. =====
  62. To use ExtraBar you first need to load it, a window will then open. This is
  63. the extra bar. On the extra bar there will be an icon with the time and date
  64. in it. Dragging files, directories and applications on to the bar will
  65. create a button with the items name and sprite in it. Clicking on that icon
  66. runs the item that created it. Shift and Ctrl have the same effect as they
  67. normally would have if you where double clicking in a directory.
  68.  
  69. You can also create an empty button from the 'Button > New button' menu
  70. item. Selecting this item creates a blank button with the name Undefined and
  71. a small ExtraBar file for it's sprite. It has no commands defined for it so
  72. clicking on it will show an error. You can alter any button that you create
  73. at anytime.
  74.  
  75. If you click on the background of the extra bar with MENU and also have the
  76. Ctrl key held down then the extra bar's position will be toggled. If it is
  77. hidden then it will come to the front, if it is already at the front then it
  78. will go to the back.
  79.  
  80. To save any buttons that you have created you need to use the save window.
  81. If you click on the save menu item that leads to the save window then the
  82. file will be saved to where it was loaded from or the save window will open.
  83.  
  84. Auto loading a file
  85. ===================
  86. You can make Extrabar load a set of buttons every time it's loaded by saving
  87. a buttons file as the default. This is very simple as all you need to do is
  88. from the 'Toolbar' submenu select the 'Save default' menu item. So long as
  89. ExtraBar is not loaded via a double click on one of it's buttons it will
  90. load.
  91.  
  92. Altering a button
  93. =================
  94. If you wish to change a button's configuration then by opening the main menu
  95. over it and going the to main menu and then to the;
  96.  
  97.                 Button => Alter button
  98.  
  99. dialogue box allows you change it configuration easily. The top icon is
  100. where you can enter the text that will appear in the button, and the icon
  101. below that is the sprite name for the the sprite you want to appear in the
  102. button. Below these are the command icons where you type in the the command
  103. that you want to be issued when the button is clicked on with SELECT or
  104. ADJUST.
  105.  
  106. You can also make the button the last one on the row which forces any
  107. subsequent button to move downwards as well as putting a gap after the
  108. button.
  109.  
  110. At present you can make the button run a number of commands. You can also use
  111. the short two letter version of the command if you wish.
  112.  
  113. They can be;
  114.  
  115.   • A star command.
  116.  
  117.     Syntax:  * <command>
  118.  
  119.   • 'Caret_Back' moves the caret back n places.
  120.  
  121.     Syntax:  Caret_Back <places>
  122.  
  123.   • 'Caret_Forward' moves the caret forward n places.
  124.  
  125.     Syntax:  Caret_Forward <places>
  126.  
  127.   • Emulate a key press. You will need to use
  128.     KeyCode to find out the value to use.
  129.  
  130.     Syntax:  Emulate_Key <Key code>
  131.  
  132.   • Opens a menu created from the contents of a
  133.     directory.
  134.  
  135.     Syntax:  Filer_Menu <Directory path>
  136.  
  137.   • Opens a menu created from a user definable menu file.
  138.  
  139.     Syntax:  User_Menu <Menu file path>
  140.  
  141.   • 'Insert_Contents' moves the caret forward n places.
  142.     Takes a file and sends it's contents to the the
  143.     current application with the input focus.
  144.  
  145.     Syntax:  Insert_Contents <file>
  146.  
  147.   • 'Insert' takes a string and sends to an
  148.     application, no special actions are taken except
  149.     changing '|m' to a Return press.
  150.  
  151.     Syntax:  Insert "<text>"
  152.  
  153.   • 'Insert_text' in to an application, after
  154.     passing it to GSTrans and inserting any time
  155.     variables that may have been used. ie. %m3 will
  156.     become Jun, Dec, etc.
  157.  
  158.     Any system variables that are named will be
  159.     convertted to the value that they are set to.
  160.     ie. Insert_text "<Wimp$State>" will send the
  161.     work 'desktop' to the application.
  162.  
  163.     If you want to send a < or " to an application
  164.     you must first put a | in front of it. You can
  165.     also send a Return with |m and a | with ||.
  166.  
  167.     Syntax:  Insert_text "<string>"
  168.  
  169.   • 'Save_file' opens a window allowing you to save
  170.     a file from one place to another. For example
  171.     you could use this call to allow the user to
  172.     save a file to a directory after a processing
  173.     activity (Jpeg to Sprite, etc...)
  174.  
  175.     Syntax:  Save_File <directory>
  176.  
  177.   • 'Web' Will send a request to any web browsing
  178.     software to go to a particual page. Can be
  179.     http://, mailto:, telnet:// or any other
  180.     protocolo.
  181.  
  182.     Supported by Termite and Fresco
  183.  
  184.     Syntax:  Web <Web address>
  185.  
  186.   • 'Task_Loaded' will execute a command if an application is loaded or an
  187.     optional command if it is not.
  188.  
  189.     Syntax:  Task_loaded <appname> then <command> [else <command>]
  190.  
  191.   • 'Task_NotLoaded' will execute a command if an application is not loaded
  192.     or an optional command if it is. The application name <appname> is the
  193.     same as the one that appears in the task window. It is a case-
  194.     sensitive. If the application's name includes spaces it should be
  195.     surrounded by quotes.
  196.  
  197.     Syntax:  Task_notloaded <appname> then <command> [else <command>]
  198.  
  199.   • 'ModTask_Loaded' will execute a command if an module task is loaded or
  200.     an optional command if it is not.
  201.  
  202.     Syntax:  ModTask_loaded <appname> then <command> [else <command>]
  203.  
  204.   • 'ModTask_NotLoaded' will execute a command if an module task is not
  205.     loaded or an optional command if it is. The module task name <appname>
  206.     is the same as the one that appears in the task window. It is a case-
  207.     sensitive. If the module's name includes spaces it should be surrounded
  208.     by quotes.
  209.  
  210.     Syntax:  ModTask_notloaded <appname> then <command> [else <command>]
  211.  
  212.   • 'AllTask_Loaded' will execute a command if an module task or application
  213.     is loaded or an optional command if it is not.
  214.  
  215.     Syntax:  ModTask_loaded <appname> then <command> [else <command>]
  216.  
  217.   • 'AllTask_NotLoaded' will execute a command if an module task or
  218.     application is not loaded or an optional command if it is. The mod