Button - ButtonRow 

The UI element Button simulates the pushbutton on the screen. The user can execute statements and actions by clicking the pushbutton.

The UI element ButtonRow can be used to arrange buttons in a row.

You can accurately arrange multiple buttons using ButtonRow. Buttons and ToggleButtons can be inserted. The ButtonRow itself does not contain any additional properties, but has the relevant methods for creating and maintaining the inserted buttons.

Definition

IWDButtoninherits from IWDAbstractButton, which is the abstract base class of pushbuttons. It inherits the ability to display an icon from the base class IWDAbstractCaption and adds the ability to display a text on the pushbutton and trigger an action.

Description of UI Element Properties

·        design

design
Describes the style of the Button UI element - for example, the button size or the highlighting of the button label.
The design property can be filled with the following values and is represented by the enumeration type WDButtonDesign.

Values	Visual Display	Short Description
emphasized		Displays the UI element with highlighted left edge.
Next		Displays the button with a triangle pointing to the right.
previous		Displays the button with a triangle pointing to the left.
standard		Displays the UI element with default background and text color.

·        imageAlt

This property is deprecated and can no longer be used.

·        imageFirst

Defines the position of the icon in relation to the corresponding text. If the value of this property is true, the icon is displayed to the left of the text.

·        imageSource

Specifies the Web address (URL) of the icon to be displayed. You can assign an absolute Web address – http:// … to this property.
If you store the icons in the directory  mimes/Components/<component class> of the Web Dynpro project in the Navigator using the menu item Import, you must only enter the icon name - for example, icon.gif. The URL Generation Service automatically determines the URL of the icon (see also URL Generation Service).
You can also store the icons in the directory mimes/Applications/<application class>. In this case, you must manually create the URL using the URL Generation Service.
If you use the SAP icons and want to refer to them, you use the alias ~sapicons. If you assign the alias ~sapicons/<name>.gif to the imageSource property, you refer to an icon called <name>.gif of the SAP icons. For a description and a listing of all possible SAP icons, see the SAP Design Guild under http://www.sapdesignguild.org/. Select the following path:
Sitemap → Resources  → Visual Design & Icons → SAP R/3 Icons → R/3 Icon Lists. 
The filename of the icon consists of the bitmap name entered in the table and the prefix “s_”. If the bitmap name in the table is F_CUTO, you must enter the value ~sapicons/s_f_cuto.gif to reference to the SAP icon .

·        size

This property is deprecated and can no longer be used.

·        text

Describes the label text of the Button UI element.

·        textDirection

Specifies the text direction and allows you to read the texts of subordinated UI elements in languages which require a specific text direction. The textDirectionproperty can be filled with the following values and is represented by the enumeration type WDTextDirection.

inherit	The text direction is inherited from the parent element. Therefore, the text direction is identical to the one of the parent element.
ltr	The text runs from left to right.
rtl	The text runs from right to left

The default value for this property is inherit.

·        width

Determines the width of the Button UI element that you can specify in CSS sizes, such as em, ex, pixels or percentage values.

Overview of Inherited and Additional Properties

Name	Interface	Type	Initial Value	Bindable	Value Required
design	IWDButton	WDButtonDesign	standard	bindable	No
enabled	IWDUIElement	boolean	true	bindable	No
imageFirst	IWDAbstractCaption	boolean	true	bindable	No
imageSource	IWDAbstractCaption	String		bindable	No
text	IWDAbstractButton	String		bindable	No
textDirection	IWDAbstractCaption	WDTextDirection	inherit	bindable	No
tooltip	IWDUIElement	String		bindable	No
visible	IWDUIElement	WDVisibility	visible	bindable	No
width	IWDButton	String		bindable	No

 

Event

This event on Action - inherited from IWDAbstractButton - is triggered when the user clicks the button.