| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
This page is for application designers. It explains how to set up actions in response to an event, such as a user mouse-click.
Overview
Often in an application, you want to trigger an action based
on the user:
- either mouse-clicking on the screem
- or pressing the enter key.
These user interactions are called events. In PhixFlow you can configure event handlers that respond to events by running a table-action or actionflow.
- OnClick: the user mouse clicks in an area.
- OnEnter: the user presses the Enter key
- in a data field.
- OnBlur: the user mouse-clicks
You configure an event handler on a specific layout component, and link it to a specific action or actionflow.
| Panel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
- out of a data field.
The event is triggered whether or not the field has changed. - OnChange: the user mouse-clicks out of a data field in which they have changed data.
Notice that this event is not triggered by the user typing into a field.
You can set event handlers on the following components:
| Event | Supported components |
|---|---|
| OnClick OnChange | Area |
| OnBlur OnEnter OnChange | Data fields:
|
| Tip |
|---|
You do not have to configure OnClick events for button components, because button actions are always triggered when the user mouse-clicks on them. |
Adding an Event Handler
- From the screen, click on a component to open its properties.
- In the Event Handler section, click
to create a new event handler.Insert excerpt _Add _Add nopanel true
Add to component
Action method
- PhixFlow opens a new properties tab for the event handler.
- Select the Event Type, Action Method and specific table-action or actionflow you require; see the properties below.
Event Handler Properties
Basic Settings
| Field | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Event Type | Select the type of event that will trigger an action:
The list shows only the events available for this type of component. | ||||||||||||||||
| Action Method | Available when Event Type is selected. Select the type of action:
| ||||||||||||||||
| Action | Available when Action Method is Table-Action.
| ||||||||||||||||
| Actionflow | Available when Action Method is Actionflow. To select an actionflow, do one of the following:
|