Start of Content Area

Background documentation ButtonChoice Locate the document in its SAP Library structure

A ButtonChoice is a button that offers various options through a triangle symbol.

If the user clicks on the triangle symbol, a menu opens from which an action can be selected. A specific action is executed when the user selects the relevant menu entry. The repeatSelectedAction property enables the action last selected to stay on the button after the action has been executed. By pressing the button it can be executed again.

A ButtonChoice functions exactly like a ToolBarButtonChoice, but it is used differently - ButtonChoice can be used outside of a tool bar.

Example of the Visual Display

This graphic is explained in the accompanying text

Note

To enable the development of accessible applications, the tooltip property is checked during the syntax check if the property text is not set.

 

Runtime Class

CL_WD_BUTTON_CHOICE

 

Properties in View Designer

Name

Type

Initial Value

Bindable

ID

STRING

(automatic)

no

enabled

WDY_BOOLEAN

true

yes

imageSource

STRING

 

yes

repeatSelectedAction

WDY_BOOLEAN

true

yes

selectedActionItem

STRING

 

yes

text

Text

 

yes

tooltip

Text

 

yes

visible

WDUI_VISIBILITY

visible

yes

 

Aggregations in View Designer

Name

Cardinality

Type

Selection

0..n

MenuActionItem

Note

Other properties that can be inherited are defined in the associated higher-level classes. The associated UI elements are:

 

      AbstractButtonChoice

      UIElement

      ViewElement

 

Dynamic Programming

For dynamic programming, the same properties, events and aggregations are available as in the View Designer. Bear in mind the different spellings.

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

enabled

ENABLED

WDY_BOOLEAN

imageSource

IMAGE_SOURCE

STRING

repeatSelectedAction

REPEAT_SELECTED_ACTION

WDY_BOOLEAN

selectedActionItem

SELECTED_ACTION_ITEM

STRING

text

TEXT

WDY_MD_TRANSLATABLE_TEXT

tooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

visible

VISIBLE

WDUI_VISIBILITY

visible: none

CL_WD_BUTTON_CHOICE=>E_VISIBLE-NONE

visible: visible

CL_WD_BUTTON_CHOICE=>E_VISIBLE-VISIBLE

 

Dynamic Programming of Aggregations

View Designer Name

Runtime Name

Cardinality

Selection

CHOICES

0..n

Example

You can find an example of this UI element in the system in the WDR_TEST_UI_ELEMENTS Web Dynpro application.

 

End of Content Area