Floating Tool Bar documentation Tool Bar Vers 1.98 Floating Tool Bar for AWeb. By William H. M. Parker [e-mail] 12 Aug 2000 - Free Ware Index Installation How does it work ? Using the Tool Bar Script Buttons Menus ARexx Host Adding commands to AWebs menu Installation The files ToolBar.AWebrx and ToolBar_Doc.html belong in 'AWeb3:plugins/'. ToolBar will actually work anywhere as long as both of its files are kept in the same drawer. AWNPipe-handler should be in L:. Both AWNPipe and AWNPipe.info should be in Devs:DOSDrivers. You might need to reboot after updating the pipe handler. The ToolBar script may be called directly from AWebs Menu, from an AWeb GUI Button, or a KeyBoard shortcut. GUI Button name ToolBar command run AWebPath:plugins/ToolBar.AWebrx Menu Type Item Title ToolBar command run awebpath:plugins/toolbar.awebrx KeyBoard Shortcut Key ALT T command run AWebPath:plugins/ToolBar.AWebrx The 'q' option will stop ToolBar from removing AWebs gui when toolbar is run. run AWebPath:plugins/ToolBar.AWebrx q For other runtime options see Adding Miami commands to AWebs menu. If you don't use the AWebPath: assign you must use FullPath/ToolBar.AWebrx ARexx limits file name length so the use of the assign is preferred. How does it work ? The ToolBar GUI is built directly from ARexx using AWNPipe:. The script looks at your AWeb configuration and uses your default button images, transfer animation, user buttons, and navigation settings. It also uses its own settings stored in env:AWeb3/cpwindow or env:AWeb3se/cpwindow. ToolBar polls AWeb once or twice a second to see the current URL and status information so you might notice a slight delay. The transfer animation is continuous when AWeb is trying to retrieving files. It does not stop and start with network activity likes AWebs native animation. Using the ToolBar Script Simply click the GUI button, call from the Menu, or use the KeyBoard Shortcut to run the ToolBar.AWebrx script. This causes AWebs GUI to be removed and the ToolBar to be displayed. If you try to run ToolBar and it is already running, the ToolBar is simply brought to the front of the screen. The GUI is restored when you quit ToolBar and its size and position are saved to be used next time ToolBar is run. The ToolBar functions always relate to the LAST ACTIVE AWeb window. This allows the single ToolBar to be used to control multiple AWeb windows. The number in the left of ToolBars title bar tells you which AWeb window is currently being controlled. Just click in a different window to switch control ToolBar may be iconified onto the workbench. Files dropped on the icon will be automatically loaded by AWeb. Pressing the 'Help' key while the ToolBar window is active will display this document. Buttons ToolBar uses your configured navigation settings for the standard buttons in order to properly emulate AWebs GUI. When these are not set, or you are using AWeb3SE the defaults are used. Defaults Top row History back - History forward - Home page - Hotlist add - Hotlist show Defaults Bottom row Stop - Network status - Search - Reload - Load images NEW FUNCTIONS Clicking the transfer animation will open the window history. Holding the shift or Alt key while clicking some buttons allow you to access additional functions. (shift or alt) Hotlist Show will display the hotlist manager. (shift or alt) Network Status will display the information window. (shift or alt) Reload will flush all nondisplayed documents. (alt) load images will flush all nondisplayed images. (shift) load images will flush all images. (shift or alt) And the transfer animation will display the cache browser.. (shift) Stop will stop the loading of all files EXCEPT those relating to the current page. Also the types of files set in the 'Control/do not Disturb menu' are not stopped. (alt) Stop will stop the all file all files EXCEPT those in the 'Control/do not Disturb menu' . The URL pulldown gadget has new entries. You can copy AWebs current URL to and from the clipboard unit 0. You can also display the documentation for AWeb or ToolBar. The configured user buttons are displayed in a pulldown menu called 'User' rather then as a row of buttons. This allows the toolbar to be smaller and a larger amount of user functions to be displayed. Menus Project Menu Snapshot / Unsnapshot - These determine if toolbars size and position are remembered. ToolBar docs - Load the ToolBar documentation in AWeb. Information - Displays information about your version of ToolBar. Quit - Quit the ToolBar. Control Menu The first two items allow you to turn AWebs regular user and navigation buttons off or on. Useful if you run ToolBar with the 'q' option. The Bubble Help item turns the help option off and on. The Do Not Distrub items tell ToolBar which DL not to cancel when you shiftclick the stop button. See Buttons NEW FUNCTIONS. Miami Menu The miami menu is only displayed if ToolBar thinks you have miami installed. This means if Miami is already running or you have a Miami: assign. You can start or stop Miami, go online or offline, or get miami status. Setting the ssl version will allow miami SSL to function with certain problem sites. See the Miami ssl documentation for more on this. Hotlist Menu ToolBar scans your hotlist looking for a group called .ToolBar. If it is found ToolBar adds a menu called hotlist containing the links from that group. Subgroups inside '.ToolBar' are displayed as sub menus. You may use more than one subgroup, but you can not nest inside subgroups. (.ToolBar/thisgroup/thatgroup..) will not work. The . at the start of .ToolBar is required and causes the group to sort to the start of your hotlist to speed up ToolBars scanning. You may need to edit the names of the hotlist links and shorten some so they fit better in the menu. ARexx Host Yes, this arexx script also has its own arexx host, don't let it bug you.8-D The hosts name is AWEBTOOLBAR and it only understands two commands. Quit - quit the ToolBar. Front - bring the ToolBar to the front of the screen. These are used internally by toolbar. You can also call them from your own scripts. If you force AWeb to open a new window bring the toolbar back to the front automatically afterwards. Here is a short example. 'NEW file://localhost/'filename if show('P','AWEBTOOLBAR') then address AWEBTOOLBAR 'front' Adding commands to AWebs menu The stopall and yeild functions (same as alt and shift stop button) can be added to awebs menu. Use the following setting. MENU S;run awebpath:plugins/toolbar.awebrx x stopall;Stop most tranfers MENU S;run awebpath:plugins/toolbar.awebrx x yeild;Yeild transfers The Miami control functions in ToolBar can be added directly to AWebs menu. Use the following setting. MENU I;;Miami MENU S;run awebpath:plugins/toolbar.awebrx m on;Online MENU S;run awebpath:plugins/toolbar.awebrx m off;Offline MENU S;run awebpath:plugins/toolbar.awebrx m stat;Status MENU S;run awebpath:plugins/toolbar.awebrx m show;Show MENU S;run awebpath:plugins/toolbar.awebrx m hide;Hide MENU S;run awebpath:plugins/toolbar.awebrx m sslv 2 ;SSL Vers 2 MENU S;run awebpath:plugins/toolbar.awebrx m sslv 3 off;SSL Vers 3 MENU S;run awebpath:plugins/toolbar.awebrx m sslv auto off;SSL Vers auto MENU S;run awebpath:plugins/toolbar.awebrx m quit;Quit Miami The toolbar does NOT need to be running for the AWeb menus to control Miami.