class %ZEN.Component.group
extends abstractGroup
Container component.
A group is used to contain and layout a set of child components.
• parameter DEFAULTCELLALIGN;
Subclasses can set this to change default cellAlign for a group.
• parameter DEFAULTCELLSIZE;
Subclasses can set this to change default cellSize for a group.
• parameter DEFAULTCELLSTYLE;
Subclasses can set this to change default cellStyle for a group.
• parameter DEFAULTCELLVALIGN;
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.
• parameter DEFAULTGROUPSTYLE;
Subclasses can set this to change default groupStyle for a group.
• parameter DEFAULTLABELPOSITION = "top";
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.
• 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 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 cellStyle
as %ZEN.Datatype.style [ InitialExpression = ..#DEFAULTCELLSTYLE ];
Specifies additional style for cells layed out within this group.
This is primarily intended for cell padding.
• 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 groupClass
as %ZEN.Datatype.cssClass [ InitialExpression = ..#DEFAULTGROUPCLASS ];
Optional CSS class used for table displayed by this group.
• property groupStyle
as %ZEN.Datatype.style [ InitialExpression = ..#DEFAULTGROUPSTYLE ];
Optional style used for table displayed by this group.
• 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 layout
as %ZEN.Datatype.string(MAXLEN=250) [ InitialExpression = ..#DEFAULTLAYOUT ];
Specifies how components within this group should be layed out. (VALUELIST = ",vertical,horizontal")
• 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.target) ? zenEvent.srcElement : zenEvent.target;
// all enclosing divs will define an attribute called 'zen'.
var zen = target.getAttribute('zen');
if (zen) {
}
• method %DrawHTML()
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.
• method %OnDrawEnclosingDiv()
as %String
Override this method to inject additional event handlers into the enclosing div.
• method 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.
