Start of Content Area

Object documentation Button Group  Locate the document in its SAP Library structure

Definition

Web item for a group of buttons that can execute one or more commands from the Web Design API, as selected.

Use

Using the Button Group Web item, you can add commands from the Web Design API to your Web application. To do this, you define a command or sequence of commands for each button. You can insert any text (language-dependent and language-independent) for the button labels, assign a quick link to them, and specify their design.

Structure

The following information lists the parameters for the Button Group Web item, arranged according to the various parameter groupings.

Display

Parameter

Description

Width in Pixels (WIDTH)

You use this parameter to specify the width of the Web item.

Height in Pixels (HEIGHT)

You use this parameter to specify the height of the Web item.

Visibility (VISIBILITY)

You use this parameter to specify whether the Web item is to be visible in the Web application.

With Tray (WITH_TRAY)

You use this parameter to specify whether the Web item is to be displayed with an icon that allows it to be expanded and collapsed in the Web application. For more information about this parameter, see Parameter Tray.

Internal Display

Parameter

Description

Button Width (BUTTON_WIDTH)

Default value: "0"

You use this parameter to specify the width of each button. The default value adjusts the button width to the length of the text.

List of Buttons (BUTTON_LIST)

 

You use this parameter to create the list of buttons for the Web application. You specify the following parameters for each button:

      Caption (CAPTION)

You use the text input dialog to enter the text to appear on the button. You can select whether the texts are to be language-dependent or language-independent. See Text Input Dialog.

      Quick Info (TOOLTIP)

You enter a quick info text here. The text for the quick info can be created according to various criteria, in the same way as the caption. See the Caption parameter.

      Icon (ICON)

You use this parameter to add an icon to the button. See also Storing and Including Images and Icons.

      Enabled (ENABLED)

You specify whether the button is to be enabled in the Web application.

      Design (BUTTON_DESIGN)

You select the design for the button:

Standard (STANDARD)

Emphasized (EMPHASIZED)

Previous (PREVIOUS)

Next (NEXT)

      Action (Command Triggered) (ACTION)

You use this parameter to link the button to an action. You first specify the type of action. You can insert the following actions:

       Command via Command Wizard (INSTRUCTION)

Using the pushbutton to the right of Command (INSTRUCTION), you can call the command wizard to insert the command (see Commands).

       Script Function (SCRIPT_FUNCTION)

In the Script Function field, you specify a script function to be executed.

You generate the script function using the script Web item that you previously added and set in the Web template.

      With Release Action (WITH_RELEASE_ACTION)

If you activate this parameter, you can define an additional action under the following parameter Action (Command Triggered) (ACTION). The button is used in the Web application as follows: When the user first chooses the button, the action is executed and the button remains depressed. When the user chooses the button again, the action defined for With Release Action (WITH_RELEASE_ACTION) is executed.

      Execute With ENTER

(FIRE_ACTION_ON_ENTER_KEYPRESS)

If you activate this parameter, the action that you defined under Action (Command Triggered) (ACTION) is triggered when you press ENTER.

Behavior

Parameter

Description

Allow Navigation (INTERACTION_ALLOWED)

You use this parameter to specify whether navigation or other interaction is to be possible in the Web application.

 

 

End of Content Area