object = DFrame or Bar

object: addBarLayer

object: useBarLayer

BarLayer: setStdBarLayer

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

Syntaxes

object.addBarLayer()

object.useBarLayer(barLayer)

BarLayer.setStdBarLayer(mode)

Parameters

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.

Return value

BarLayer for addBarLayer methods.

no return value for useBarLayer and setStdBarLayer methods.

Usages

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.