A Bar is an area containing BarLayers. BarLayers are layers on wich Buttons and Menus are created. A default BarLayer is created with each Bar.
object.addBarLayer: Create a Bar and a BarLayer. Same as DFrame.addBar but returns a BarLayer object.
object.useBarLayer: Hide all BarLayers of the BarLayer's Bar except the one specified.
BarLayer.setStdBarLayer: Set a BarLayer to be shown (and others BarLayers of the same Bar to be hidden) for edit or read modes, depending on the parameter.
Demo
file: addBarLayer.html
Run the
example
See the source code
object.addBarLayer()
object.useBarLayer(barLayer)
BarLayer.setStdBarLayer(mode)
barLayer
useBarLayer method.
BarLayer object.
mode
setStdBarLayer method.
String
§
Use 'READ' (not
case sensitive) to define the BarLayer that will be shown if there is no form
in the page contained by the DFrame.
§
Use 'EDIT' (not
case sensitive) to define the BarLayer that will be shown if there is at least
one form in the page contained by the DFrame.
BarLayer for addBarLayer methods.
no return value for useBarLayer and setStdBarLayer methods.
BarLayers are transparent and have no style. But buttons and Menus contained in a hidden BarLayer cannot be seen.
DFrame.addBarLayer:
Used most of time in conjunction with useBarLayer.
As no BarStyle is defined with this method the Bar of the BarLayer is created
with the default BarStyle property of the DFrame's style.
Bar.addBarLayer:
Allow you to create many BarLayers in a Bar.
Used most of time in conjunction with useBarLayer.
BarLayer.setStdBarLayer:
If a DFrame can receive documents containing forms and others without forms you can create 2 BarLayers having different Buttons and/or Menus and set one as the 'Read BarLayer' and the other one as the 'Edit barLayer'. The right BarLayer will be shown and all others hidden depending on the presence or not of a form in the document.
Note: The BarLayer object has a show method. If this method is used to a BarLayer with the true parameter all other BarLayers are hidden.