object =  DFrameStyle, BarStyle and ButtonStyle

object: setOverlayParentBars

Allow a object to recover the Bars of its parent.

Syntaxes

object.setOverlayParentBars(flag)

Parameters

flag

If true the position of the of the new object are not relative to the free area of the parent DFrame but to the whole parent area.

Usage

DFrame usage:

When a DFrame is added to another one it is added on the free area of the parent DFrame, ie the area remaining free after bars are added. See DFrame class. The use of the setOverlayParentBars allow the child DFrame to recover the bars of the parent DFrame. In this case the position of the DFrame is not computed starting on the free space (space remaining free after Bars are drawn) but on the total area of the DFrame.

Bar usage:

As the main use of this method is to set positions of DFrames it can also be used for floating Bars: If a setFreezeXXX position is set to protect floating Bars from a child DFrame this value will make impossible a floating Bar to recover another floating Bar and the indentX and indentY values could not be applied correctly.

Button usage:

Common Buttons are always added to Bars, even if created with the DFrame.addButton method: In this case the default Bar is created or used if already exists.

On the contrary text Buttons, created with the See DFrame.addText method are created on DFrames and thus can, if the overlayParentBars value is set to true, recover its DFrame Bars. In this case the position of the Button is not computed starting on the free space (space remaining free after Bars are drawn) but on the total area of the DFrame.