Entering content frame

Background documentation TimedTrigger Locate the document in its SAP Library structure

The TimedTrigger UI element automatically and periodically triggers an event with a specified delay. The TimedTrigger UI element is not displayed on the user interface. Therefore, it ignores the tooltip and the visibiltyproperty. However, in specific layouts such as the matrix layout it takes up space. To trigger an action, you must bind the onAction property to an action. You use the delay property to specify the delay in seconds.

If events are not to be triggered by the TimedTrigger UI element, you do the following:

·        Set the value of the delay to 0 seconds

·        Disable the TimedTrigger UI element

·        Set the visibility property to a value not equal to visible

Caution

Every user interaction is interrupted when the onAction is triggered.

In the Web Dynpro application, you can use, with restrictions, periodical server requests and the TimedTrigger UI element to trigger push events – that is, the controlled triggering of events, for example, as a message for the user. When using the TimedTrigger UI element, the client actively retrieves the data from the server. Due to the considerable server load, you should only use this option if a small number of clients exists.

Note

In the design time the tooltip is not checked to ensure Accessibility, since there is no use for a tooltip with this UI element.

 

Runtime Class

CL_WD_TIMED_TRIGGER

 

Properties in the View Designer

Name

Type

Initial Value

Bindable

ID

STRING

(automatic)

no

delay

I

0

yes

enabled

WDY_BOOLEAN

true

yes

tooltip

Text

 

yes

visible

WDUI_VISIBILITY

visible

yes

 

Events in the View Designer

Name

onAction

Note

Further properties that can be inherited are defined in the associated higher-level class.  The associated interface elements are:

·         UIElements

·         ViewElements

Data Binding

You can use the onAction property to specify the action that is to be triggered after a specific delay.

Dynamic Programming

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

Dynamic Programming of Properties

View Designer Name

Runtime Name

Type

delay

DELAY

I

enabled

ENABLED

WDY_BOOLEAN

tooltip

TOOLTIP

WDY_MD_TRANSLATABLE_TEXT

visible

VISIBLE

WDUI_VISIBILITY

 visible: none

CL_WD_TIMED_TRIGGER=>E_VISIBLE-NONE

 visible: visible

CL_WD_TIMED_TRIGGER=>E_VISIBLE-VISIBLE

 

Dynamic Programming of Events

View Designer Name

Runtime Name

onAction

ON_ACTION

Example

You can find examples of this interface element in the system in the Web Dynpro application WDR_TEST_UI_ELEMENTS, and in the component WDR_TEST_EVENTS in the view TIMEDTRIGGER.

 

 

Leaving content frame