ButtonChoice

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

BUTTONCHOICE

Note

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

Runtime Class

CL_WD_BUTTON_CHOICE

Properties in View Designer

Name	Type	Initial Value	Bindable
id	STRING	(automatic)	No
activateAccessKey	WDY_BOOLEAN	false	No
contextMenuBehaviour	WDUI_CONTEXT_MENU_BEHAVIOUR	inherit	No
contextMenuId	WDY_MD_UI_ELEMENT_REFERENCE		No
enabled	WDY_BOOLEAN	true	Yes
imageSource	STRING		Yes
repeatSelectedAction	WDY_BOOLEAN	true	Yes
selectedActionItem	STRING		Yes
text	Translatable text		Yes
tooltip	Translatable text		Yes
visible	WDUI_VISIBILITY	visible	Yes

Aggregations in the View Designer

Name	Cardinality	Type
CHOICES	0..n	MenuActionItem

Note

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

Dynamic Programming

For dynamic programming, the same properties, events, and aggregations as in the View Designer are available. But note that the spelling format and use of upper/lower case is different.

Dynamic Programming of Properties

View Designer Name	Runtime Name	Type
activateAccessKey	ACTIVATE_ACCESS_KEY	WDY_BOOLEAN
contextMenuBehaviour	CONTEXT_MENU_BEHAVIOUR	WDUI_CONTEXT_MENU_BEHAVIOUR
contextMenuBehaviour: inherit	CL_WD_BUTTON_CHOICE=>E_CONTEXT_MENU_BEHAVIOUR-INHERIT
contextMenuBehaviour: provide	CL_WD_BUTTON_CHOICE=>E_CONTEXT_MENU_BEHAVIOUR-PROVIDE
contextMenuBehaviour: suppress	CL_WD_BUTTON_CHOICE=>E_CONTEXT_MENU_BEHAVIOUR-SUPPRESS
contextMenuId	CONTEXT_MENU_ID	WDY_MD_UI_ELEMENT_REFERENCE
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
CHOICES	CHOICES	0..n

Example

You can find an example of this UI element in the system, in Web Dynpro component DEMO_UIEL_STD_ACTION.