Group

Definition

A framed panel to visually group controls. See also 'tray'.

design

The design of the group that refers to CSS. You can select
- PRIMARYCOLOR
  
  The panel of the group is filled with the same background as the title bar (primary color).
- SAPCOLOR
  
  The title bar and the frame around the panel is in SAP blue and the panel has a white background.
- SECONDARYBOX
  
  No frame around the panel. Title bar with background color (primary color), panel has a white background.
- SECONDARYBOXCOLOR
  
  The panel is filled with a background color that is different from the title background color (primary color). No frame around the panel.
- SECONDARYCOLOR
  
  The panel is filled with a background color that is same as the title background color (secondary color).
headerComponent

Set a component for the group header.
id

Identification name of the group.
title

Defines the string of text placed left aligned in the title bar. If no title should be displayed an empty string (null) can be used. The width of the group is automatically adjusted to the length of the text when the 'width' attribute is set smaller than the title text width.
tooltip

Defines the hint of the group which is displayed as the mouse cursor passes over the group, or as the mouse button is pressed but not released.
width

Defines the width of the group. The width of the group is automatically adjusted to the length of the 'title'. To see an effect of the 'width' attribute 'width' has to be set higher as the width defined through the length of the 'title' string. If an empty (null) 'title' string is set no 'title' attribute is defined the width of the group is set according to the 'width' attribute.

Attributes	M	Values	Usage
design	*	PRIMARYCOLOR SAPCOLOR SECONDARYBOX SECONDARYBOXCOLOR SECONDARYCOLOR	Taglib design="SAPCOLOR" Classlib `setDesign(GroupDesign.SAPCOLOR)`
headerComponent		Component	Taglib No tag available Classlib `setHeaderComponent(Component c)`
id	*	String (cs)	Taglib id="Intro_Text" Classlib setId ("Intro_Text")
title		String	Taglib `title="Headlines"` Classlib `setTitle ("Headlines")`
tooltip		String	Taglib `tooltip="latest news"` Classlib `setTooltip ("latest news")`
width		Unit (50%)	Taglib width="300" Classlib setWidth ("300")

groupBody

Defines the items in the group. The groupBody tag has to be placed in a group tag. A groupBody can be filled with any control (checkbox, image, textView etc.).

groupHeader

Defines the header of the group. The groupHeader tag has to be placed in a group tag. A groupHeader can be filled with any control (checkbox, image, textView etc.). The control in the groupHeader is placed on the right side of the group title.

Example

using the taglib

  <hbj:group 
  id="HeadlineNewsGroup" 
  design="SAPCOLOR" 
  title="latest headlines" 
  tooltip="all the news you need" 
  width="50%" 
  >
  <hbj:groupBody>
    <hbj:textView 
      encode="false" 
      text="The NASDAQ on an upswing<br>Good news for homeowners" 
      />
  </hbj:groupBody>
  </hbj:group>

using the classlib

    Form form = (Form) this.getForm();
    Group group = new Group();
    group.setDesign(GroupDesign.SAPCOLOR);
    group.setTitle("latest headlines");
    group.setTooltip("all the news you need");
    group.setWidth("50%");

    TextView tv = new TextView("tv");
    tv.setEncode(false);
    tv.setText("The NASDAQ on an upswing<br>Good news for homeowners");
    group.addComponent(tv);
    form.addComponent(group);

Result