How to get rid of an XUI toolbar, using ACL?

Tung Fu (PTC) gives three varieties Last Updated: 2006-08-08

Three ACL functions can "close" a toolbar in Epic 5.2.


 * 1) dlgitem_hide.
 * 2) The toolbar still exists in the memory.
 * 3) The name of the toolbar still appears in the Toolbars menu item.
 * 4) The user can select the Toolbars menu item to show the toolbar.
 * 5) The script can call dlgitem_show to show the toolbar.
 * 6) dlgitem_withdraw
 * 7) The toolbar still exists in the memory.
 * 8) The name of the toolbar is removed from the Toolbars menu item.
 * 9) Use dlgitem_display to display the toolbar again.
 * 10) dlgitem_remove_toolbar
 * 11) The toolbar is destroyed and cannot be revived.
 * 12) If you need the toolbar, load a new instance from the XUI file.

The ACL dlgitem_exists can be used to check if a toolbar exists.

NOTE:

dlgitem_remove_toolbar takes two parameters:

dlgitem_remove_toolbar(window, dlgitem)

The "window" is a window identifier. The "dlgitem" is the value of a toolbar's id attribute. If the "dlgitem" is not a toolbar in the "window", $ERROR is set, and 0 is returned. Otherwise, the toolbar is removed and 1 is returned.

This ACL function is new (since 5.1). It will be documented in a later release.