container widget designed for creating binary partitions of an
area of the active display. An activeVGroup is always specified
with exactly two children (any excess are ignored). These
children may have an arbitrary number of children of their own
but at the top level the strict limit is enforced.
On the client-side, the component will be rendered as a split pane with top and bottom partitions, potentially separated by an adjustment handle. If no geometry restrictions are specified, the component will attempt to size itself to fill all available space remaining in the browser window (this behavior, can of course be overridden by CSS).
There are several properties governing the nature and handling of the partioning. The split may be speficied as an absolute reserve of pixels for the top or bottom pane (with excess pixels going to the other) or as a constant percentage to be reapportioned in actual pixels whenever the widget's container is resized. The split can be marked as either fixed or user-adjustable. It is possible specify child panes that slide open to a predefined taller height when the mouse rolls over them and auto-close when the mouse leaves the region. In the case of auto-expanding panes, it is possible to define sound effects to accompany the animation.
To be compatible with the static layout manager the enclosing class has to be the generic activeGroup rather than the specific activeVGroup The activeVGroup is the one used for tuning attributes of the absolutely positioned elements. parameter INCLUDEFILES = "zenCSLM.js,zenActiveVGroup.js";
CSV list of additional include files (either .js or .css) that should be included when this component is used on a page.
By default, the file extension (.js or .css) is used to determine whether an item in the list is a script include or a style include. You can override this behavior by adding the terms "script:" or "style:" to the beginning of the file name or names. This prefix is not used as part of the include filename.
If defined, this property indicates that one of the two panels is an auto-open/auto-close sidebar panel and that the panel should expand when the mouse enters its "split"-defined bounds and grow until it reaches the height given in the autoExpand parameter. The value is always interpreted in pixels. A positive value designates the top pane for auto-expansion. A negative value designates the bottom. property handlePattern as %ZEN.Datatype.string;
The default value (null) indicates that the auto-expansion feature is not used by this instance of the widget.
This indicates a file name for an image to use for painting the dragable partition handle. This image should be at least as tall as the handle thickness and is repeated horzontally along the length of the handle. property handleThickness as %ZEN.Datatype.string;
The default value is a PNG file of a top-highighted gray gradient, bounded by black on either side.
This indicates the height of the pane partition handle in pixels. Due to the dynamic functional nature of the element, the height of this bar cannot be set via CSS and must be specified via this property. property noResize as %ZEN.Datatype.string;
The default value is "7", resulting a drag handle a little under one eight of an inch (2 mm) thick on most screens.
if true, this indicates that the user is not to be allowed to resize the panes. property onresizeBottom as %ZEN.Datatype.eventHandler;
If false, user adjustment of the pane sizes is allowed via dragging the pane handle with the mouse. If user resizing is enabled, the mouse pointer will change to a north-south resize cursor when the mouse is in potential drag position.
The default value is "false"
onresizeBottom event handler: This event is fired when the bottom panel of this component is resized property onresizeTop as %ZEN.Datatype.eventHandler;
onresizeTop event handler: This event is fired when the top panel of this component is resized property soundFX as %ZEN.Datatype.string;
This indicates a sound file to be played when an auto-expansion window grows or shrinks. If not defined or null, no sound accompanies the animation. property split as %ZEN.Datatype.string;
The default is "null"
Defines the division between the two panes.
A value with a % sign is interpreted as a proportional division between the top and bottom panes and is recalculated to maintain this ratio whenever the base division is resized by any means. Manual adjustment of the value continues to be interpreted as a percentage split.
A positive value not constaining a percent sign is interpreted as a fixed reserve height for the top child. Any adjustments to the total height of the base container are reflected in the geometry of the bottom pane only.
A negative value (which cannot contain a % sign) is interpreted as a fixed height for the bottom pane. Any adjustments to the total height of the base container are reflected in the geometry of the top child.
Manual adjustment of a top or bottom reserved height will change the size of the reserve and these fixed sizes will be respected even as the window is resized.
The default split is "50%"