Show TOC Start of Content Area

Object documentation Group  Locate the document in its SAP Library structure

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

This graphic is explained in the accompanying text

 

 

End of Content Area