The toolbar manager is a menu that contains items for controlling custom toolbars.  It can be used to save toolbars to a library and to an internal store and later restored to the view.  The open toolbars can be hidden to get them out of the way temporarily and then made visible again.  This is useful for switching between model and workspace since custom toolbars are visible on top of modelspace windows.  A script file, ToolbarControl, is added to the Layouts - Configurations library to create a tab button that can be pressed to recreate the toolbar, this is useful when switching layouts.

The menu installs automatically when loaded and html help can optionally be installed.

The toolbar tools menu has the bulk of the functionality. The first 4 items looks for a toolbar dimension change.  In fact they will look for any ui change.

1. If adding a toolbar to the open toolbar menu, change it's appearance first(1D,2D, horizontal or vertical) and use step 3 to change it back to the desired appearance.
2. choose the menu option
3. change a toolbar by changing between 1D and 2D or between horizontal or vertical
4. the action is performed(select, open in LE, save to store or save to library)

• select toolbar is used to select a toolbar node.  This is useful for renaming the toolbar.  It is very important to rename the toolbars so that they have meaningful names when placed inside the open toolbar menu.

• open toolbar or frame in the LE will open a fresh link editor window and point it to the frame holding the toolbar.  This also works for wndows and menus.

• select and add toolbar saves the toolbar to an internal store and adds a menu item to the open toolbar menu. 

• save toolbar to library will save the toolbar node to a library called Objects - CustomToolbars. 

• load toolbar from library opens a dialog in the panel view that allows the selection of the toolbar in the toolbar library or the option to load all the toolbars in the library via a checkbox.  This will load the toolbars to the store and add menu items for each one in the open toolbar menu. 

• open toolbar store will open the toolbar store in the link editor.  This is useful for removing unwanted toolbars from the manager.  

• refresh toolbar menu will recreate the toolbars using the toolbars found in the store. 

• help opens the html help panel if help was installed.

   The open toolbar menu starts with a dummy button that does not do anything.

The toolbar visibility menu has options for hiding and un-hiding toolbars(hide visible, show hidden). This feature only knows about the toolbars listed in the open toolbar menu. Useful for switching to modelside where the toolbars would obscure the view. A third menu item, display all, is used to recreate the custom toolbars from the open toolbar menu list.

The steps for recreating a toolbar after a layout change are as follows:

1. Press the ToolbarControl found in the Layout tabs
2. Press display all found in the toolbar visibility menu

This system was designed for custom toolbars that exist in the 3d view.  If other items outside of a 3d view like the top menu or the bottom toolbar are used the results may be unpredictable when attempting to reload them(then again it may work just fine).

Dev Notes:

The html help file is stored in \HTMLhelp\toolbarmanager

The toolbar library is created here \Rs Main Libraries\Objects - UserToolbars

the toolbar store is in dependency graph(dg) inside  /CustomToolbars

help panel is stored in dg inside  /Scripts/HTMLhelp,  path to the html file is stored in /Scripts/HTMLhelp/htmlPanel in the htmlPath connector,  Activity.Run('/Scripts/CustomCommands/toolbarScripts/displayHelp') will run a script to open the help panel it basically sets the path to the help file and copies /Scripts/HTMLhelp/HTMLhelpPanelFrame into Project/Windows Manager Space

hide toolbars works by copy of the toolbars into /Project/tempStore and closing the toolbars,  show toolbars copies them back and deletes the tempStore