This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Home > Class Reference > %SYS namespace >

class extends %ZEN.Component.abstractGroup

Container component. A group is used to contain and layout a set of child components.

Property Inventory (Including Private)

Method Inventory (Including Private)


Subclasses can set this to change default cellAlign for a group.
Subclasses can set this to change default cellSize for a group.
Subclasses can set this to change default cellStyle for a group.
Subclasses can set this to change default cellVAlign for a group.
parameter DEFAULTGROUPCLASS = group;
Subclasses can set this to change default css class for a group.
Subclasses can set this to change default groupStyle for a group.
Subclasses can set this to change default labelPosition for a group.
parameter DEFAULTLAYOUT = vertical;
Subclasses can set this to change default layout for a group.

Properties (Including Private)

property cellAlign as %ZEN.Datatype.string (MAXLEN = 10, VALUELIST = ",left,right,center,even") [ InitialExpression = ..#DEFAULTCELLALIGN ];
Specifies horizontal alignment of cells layed out within this group.
Property methods: cellAlignDisplayToLogical(), cellAlignGet(), cellAlignIsValid(), cellAlignLogicalToDisplay(), cellAlignLogicalToOdbc(), cellAlignNormalize(), cellAlignSet()
property cellSize as %ZEN.Datatype.string (MAXLEN = 10, VALUELIST = ",same,stretch") [ InitialExpression = ..#DEFAULTCELLSIZE ];
Specifies how the size of cells within this group should be calculated (along layout direction).
Property methods: cellSizeDisplayToLogical(), cellSizeGet(), cellSizeIsValid(), cellSizeLogicalToDisplay(), cellSizeLogicalToOdbc(), cellSizeNormalize(), cellSizeSet()
property cellStyle as [ InitialExpression = ..#DEFAULTCELLSTYLE ];
Specifies additional style for cells layed out within this group. This is primarily intended for cell padding.
Property methods: cellStyleDisplayToLogical(), cellStyleGet(), cellStyleIsValid(), cellStyleLogicalToDisplay(), cellStyleLogicalToOdbc(), cellStyleNormalize(), cellStyleSet()
property cellVAlign as %ZEN.Datatype.string (MAXLEN = 10, VALUELIST = ",top,bottom,middle,even") [ InitialExpression = ..#DEFAULTCELLVALIGN ];
Specifies vertical alignment of cells layed out within this group.
Property methods: cellVAlignDisplayToLogical(), cellVAlignGet(), cellVAlignIsValid(), cellVAlignLogicalToDisplay(), cellVAlignLogicalToOdbc(), cellVAlignNormalize(), cellVAlignSet()
property groupClass as %ZEN.Datatype.cssClass [ InitialExpression = ..#DEFAULTGROUPCLASS ];
Optional CSS class used for table displayed by this group.
Property methods: groupClassDisplayToLogical(), groupClassGet(), groupClassIsValid(), groupClassLogicalToDisplay(), groupClassLogicalToOdbc(), groupClassNormalize(), groupClassSet()
property groupStyle as [ InitialExpression = ..#DEFAULTGROUPSTYLE ];
Optional style used for table displayed by this group.
Property methods: groupStyleDisplayToLogical(), groupStyleGet(), groupStyleIsValid(), groupStyleLogicalToDisplay(), groupStyleLogicalToOdbc(), groupStyleNormalize(), groupStyleSet()
property labelPosition as %ZEN.Datatype.string (MAXLEN = 10, VALUELIST = ",left,top") [ InitialExpression = ..#DEFAULTLABELPOSITION ];
Specifies where labels should be displayed for components within this group. "top" places the labels above the components. "left" places the labels to the left of the components.
Property methods: labelPositionDisplayToLogical(), labelPositionGet(), labelPositionIsValid(), labelPositionLogicalToDisplay(), labelPositionLogicalToOdbc(), labelPositionNormalize(), labelPositionSet()
property layout as %ZEN.Datatype.string (MAXLEN = 250, ZENENCRYPT = 1) [ InitialExpression = ..#DEFAULTLAYOUT ];
Specifies how components within this group should be layed out. (VALUELIST = ",vertical,horizontal")
Property methods: layoutDisplayToLogical(), layoutGet(), layoutIsValid(), layoutLogicalToDisplay(), layoutLogicalToOdbc(), layoutNormalize(), layoutSet()
property onclick as %ZEN.Datatype.eventHandler;
onclick event handler: This event is fired when the mouse is clicked on the group.
Note, if you need to specify an onclick event for a group, you have to be very familiar with event handling in HTML/JavaScript. Your event handling code will have to take into consideration that this event is fired whenever the mouse is clicked within the enclosing div element for this group. For example, clicking on a button within the group will fire the onclick handlers for both the button and the group.
You can detect if the click was directly on the group by examining the event object (passed via the zenEvent variable). For example:
// look at source element; IE does not support standard target property.
var target = (null == ? zenEvent.srcElement :;
// all enclosing divs will define an attribute called 'zen'.
var zen = target.getAttribute('zen');
if (zen) {
Property methods: onclickDisplayToLogical(), onclickGet(), onclickIsValid(), onclickLogicalToDisplay(), onclickLogicalToOdbc(), onclickNormalize(), onclickSet()

Methods (Including Private)

method %DrawHTML()
Inherited description: Static HTML display method: draw the BODY of this component as HTML.
Subclasses implement this in order to render the static HTML contents of a component.
private method %LayoutChildren(pTuple As %Integer = "")
Does the actual work of laying out the children of this group. pTuple indicates the current tuple number in the case of a repeatingGroup.
method %OnDrawEnclosingDiv() as %String
Override this method to inject additional event handlers into the enclosing div.
clientmethod setProperty(property, value, value2) [ Language = javascript ]
Set the value of a named property.
Assume that subclasses that simply wrap HTML controls have named the control 'control' or else have overridden this method.

Inherited Members

Inherited Properties (Including Private)

Inherited Methods (Including Private)


FeedbackOpens in a new window