Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

What is an Event Handler?

An Event Handler is an action that responds to a specific event, such as a mouse click, double click or enter key press. The Event Handler defines how the application behaves when the event is triggered.

Event handlers can be configured to respond to events by running a  Table-action or  Actionflow.

The types of event handler are:


Set event handlers on:
Event TypeDescriptionSupported ComponentsSupported Data Fields
On ClickThe user mouse clicks in an area.Area-
On Change

A toggle field changes state or the user mouse-clicks out of a data field in which they have changed data. 

Note: this event is not triggered by the user typing into a field.

Area

Boolean

Date

Datetime

Number

String

On EnterThe user presses the Enter key in a data field.-
On BlurThe user mouse-clicks out of a data field.
The event is triggered whether or not the field has changed.		-

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

  1. From the screen, click on a component to open its properties.
  2. In the Event Handler section, click  Add New to create a new event handler.
  3. PhixFlow opens a new properties tab for the event handler.
  4. Select the Event Type, Action Method and specific table-action or actionflow you require; see the properties below.

Event Handler  Properties

Basic Settings

FieldDescription
Event Type

Select the type of event that will trigger an action:

  • OnClick
  • OnEnter
  • OnBlur
  • OnChange.

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:

  • Table-Action
  • No action
  • Actionflow
  • Other
Action

Available when Action Method is Table-Action.

  • Either, select a table-action from the drop-down list
  • Or, to find table-actions belonging to a specific table:
    1. Click  List Tables to show tables in the repository
    2. Expand the table.
    3. Drag a table-action from the list into this box.
Actionflow

Available when Action Method is Actionflow.

To select an actionflow, do one of the following:

  • Select an actionflow from the drop-down list.
  • Click  Actionflow to show actionflows in the repository
  • Click  Add New to create a new actionflow; see Creating Actionflows. 
Other

Available when Action Method is Other.

Select from the drop down:

  • None
  • Clear All Fields: clears content from all form fields on the parent form
  • Close Screen: closes the parent screen
  • Maximise/Minimise Screen: toggles the screen between minimised and its default size
  • Screenshot: copies an image of the selected component to the clipboard. The required component must be dragged and dropped into the Screenshot Component box from the  Layers or  Repository.

1.02 Actionflow Principles

  • No labels