Selection Delay (SelectionDelay)

Enables (or disables) a delay of 200 milliseconds before firing the valueChanged trigger in the Tree widget, when using keyboard navigation.

SelectionDelay= True | False

Value

Description

True

The Tree widget fires the valueChanged trigger when a node has been selected for more than 200 milliseconds.

False

The Tree widget fires the valueChanged trigger for every node it selects.

Usage

Dynamic?

Yes

Supported in Grid?

No

Dependencies:

None

Description

When using the keyboard to navigate through the tree items, setting SelectionDelay to True ensures that the trigger is not fired before the user has really selected an item. This behavior is similar to the Windows Explorer tree view.

In some circumstances, such as data entry via a tree view, the delay may be undesirable. In this case, you can turn the delay off by setting the SelectionDelay property.

Using in ProcScript

You can use $properties or $fieldproperties to set or get the property and its value. For more information, see $properties and $fieldproperties.

$fieldproperties(FLD) = "SelectionDelay=true"
vProps = $fieldproperties(FLD1, "selectiondelay")

Setting in Initialization File

You can set the default value for this widget property in the application .ini file. For example:

;usys.ini
[widgets]
MyTree=utree(selectiondelay=false)

Applies To

utree (Tree)