Single-Click Event Processing Overview |
DEVELOPER |
 |
Previously a double click in a list box fired the Custom Validation and the Lost Focus event points, whereby the double click forced the focus from the field and the Lost Focus event was executed. This functionality has been amended and enhanced by the Single-Click functionality. Now list boxes can be configured to trigger Custom Validation event point processing when a mouse single click or keyboard entry occurs, and the focus remains on the field.
 |
Note: Multi-select list boxes do not respond to a double click, and therefore are not affected by Single-Click functionality. Also please note, multi-select list boxes do not trigger Custom Validation logic. |
Previously with check boxes and radio groups, you had to leave the field to execute a logic point. The Single-Click functionality forces the execution of the Custom Validation logic and the focus remains on the field.
Single-Click Event Processing functionality can be enabled for list boxes, check boxes and radio groups by selecting the Single Click check box on the relevant dynamic object's Properties window...Behaviour tab. You can also set this property in the Forms Designer on the object's Properties window. Alternatively, you can set option on the Object Properties Grid.
If this property is set, then a Custom Validation event is processed with a single click of the mouse, or by a data change through the keyboard.
When list boxes are enabled for the Single-Click functionality and rendered in Open Client, the type of click on the list (single or double click) box can be differentiated through the use of the ClickType property. The read-only property is automatically updated by click events on rows in list boxes. You can then read and act on the value, typically in the Custom Validation Event Logic.
A single click in an Open Client list box row with the Single-Click functionality enabled updates the list box ClickType property to the word ‘SINGLE'.
A double click in an Open Client list box row with the Single-Click functionality enabled updates the list box ClickType property to the word ‘DOUBLE’.
Any event that changes the selection in a list box when the Single-Click functionality is enabled, (i.e. the use of the cursor keys) will trigger the Custom Validation Event Logic and consequently behave as a Single-Click event. Note that anything other than single or double click leaves the ClickType property as an empty string.
The following situations do not update the ClickType property:
Click event on a list box row in PROIV Client.
Click event in an Open Client list box row when the Single-Click functionality is disabled.
Pressing ENTER or TAB in an Open Client list box when the Single-Click functionality is enabled.
When the Single-Click functionality is switched on, Event Processing occurs in the following scenarios:
|
Action |
Outcome |
|
Single-click on a previously or newly selected row |
Custom Validation event is processed. |
|
Scroll through selection list |
Custom Validation event is processed when you stop scrolling. |
|
Double-click |
Custom Validation event is processed but the cursor is not moved to the next field. In other words, the double-click works in the same way as the single-click. |
|
Action |
Outcome |
|
Single-click |
Custom Validation event is processed. |
|
Action |
Outcome |
|
Single-click on a newly selected or a previously selected |
Custom Validation event is processed. |
|
Double-click |
Custom Validation event is processed but the cursor is not moved to the next field. In other words, the double-click works in the same way as the single-click. |
The following keyboard behaviour triggers event processing:
|
Dynamic Object |
Action |
|
List Box |
Arrowing up and down the list. |
|
Check Box |
Using the space bar to tick/untick the check box. |
|
Radio Group |
Arrowing (up/down or left/right) between the radio s. |
|
Note: Custom Validation logic is not executed when a field is exited. For example, Custom Validation logic is not executed when you press the TAB or ENTER keys to move away from a field, or when you use the mouse to click onto another field. |
Setting up Single-Click Event Processing explains how to enable Single-Click functionality for a list box, edit box or radio group.
CLICKTYPE explains in further detail the ClickType property which enables you to differentiate between the type of click on a list box (single or double click).
Topic ID: 500539