Objects

List Boxes

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.

Check Boxes and Radio Groups

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.

Event Processing

Enabling the Functionality

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.

Open Client List Boxes

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.

Scenarios

When the Single-Click functionality is switched on, Event Processing occurs in the following scenarios:

List Boxes

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.

Check Boxes

Action	Outcome
Single-click	Custom Validation event is processed.

Radio Groups

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.

Keyboard Behaviour

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.

Section links:

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).

Comment on this topic

Topic ID: 500539