Component Events

Widget components may generate events when the user interacts with them. For example, a button has an action event which fires when the user clicks it.

An event may be specified as the binding activator for a binding. An "activator" causes the binding to do just that -- act, and thus write data from a widget to a context on the server, read data from a context and use it as a widget'  s content, or perform some other data processing.

Let's say we have a Name text field which is bound to a field in some server context's variable (i.e, the First Name of a user). Its binding also specifies an activator event -- the action event of the Save button, which is right next to it. When the user clicks this button, the following sequence of events occurs:

1) All bindings of the widget are scanned, looking for their specified Activator events.

2) The system sees that the binding for the Name text field has this action event defined as its "activator".

3) The binding is then executed, along with any other bindings which have this event as their activator (such as Last Name, if there is one). In simple words, the data in the text fields is now written into the database.

This section describes events that are supported by most widget components. The individual description for each component includes a list of supported common events.

This event is fired when a component is hidden.

Event name: hidden

Event fields:

This event is fired when a component is shown.

Event name: shown

Event fields:

This event is fired when a component is moved within its parent container.

Event name: moved

Event fields:

This event is fired when a component is resized.

Event name: resized

Event fields:

This event is fired when a mouse button is pressed and released over the component.

This event will not fire if there was mouse movement between pressing and releasing the button.

Use this event for reacting to single and triple click counts. Use Mouse Double Clicked event for double clicks.

Event name: mouseClicked

Parameters: see mouse event.

This event is fired when a mouse button is twice clicked over the component.

Event name: mouseDoubleClicked

Parameters: see mouse event.

This event is fired when a mouse button is pressed over the component.

Event name: mousePressed

Parameters: see mouse event.

This event is fired when a mouse button is released over the component.

Event name: mouseReleased

Parameters: see mouse event.

This event is fired when a mouse cursor enters the component area.

Event name: mouseEntered

Parameters: see mouse event.

This event is fired when a mouse cursor leaves the component area.

Event name: mouseExited

Parameters: see mouse event.

This event is fired every time when a mouse cursor moves over the component area.

Event name: mouseMoved

Parameters: see mouse event.

This event is fired when a mouse wheel is activated over the component.

Event name: mouseWheelMoved

Event fields: The mouse wheel moved event has all fields of a regular mouse event. Additionally, it defines the following fields:

This event is fired when a keyboard key is typed while the component is in focus.  

Event name: keyTyped

Parameters: see keyboard event.

This event is fired when a keyboard key is pressed while the component is in focus.

Event name: keyPressed

Parameters: see keyboard event.

This event is fired when a keyboard key is released while the component is in focus.  

Event name: keyReleased

Parameters: see keyboard event.

This event is fired when the component gets input focus.

Event name: focusGained

Event fields:

This event is fired when the component loses input focus.

Event name: focusLost

Event fields:

Was this page helpful?

Tell us more

Send

Thank you!