Tool Bar
Floating Tool Bar for AWeb.
By William H. M. Parker bill@amitrix.com

13 Sep 1999 - Free Ware


Index

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 imagesw will flush all images.
(shift or alt) And the transfer animation will display the cache browser..
(shift or alt) Stop will stop the loading of all files EXCEPT those relating to the current page. Also files ending in .lha, .zip or lzx are not stopped.

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.

AWeb Menu

This menu allows you to turn parts of AWeb GUI off and on.

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 miamis status. Toggling the ssl version 2 setting will allow miami SSL to function with certain problem sites. See the Miami ssl documentation for more on this.

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 Miami commands to AWebs menu

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 sslv2 on;SSL Vers 2 On
MENU S;run awebpath:plugins/toolbar.awebrx m sslv2 off;SSL Vers 2 Off
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.