ue_ItemClicking

Description

Occurs when the user clicks a button. This event is analogous to the DataWindow's buttonClicking event that occurs before the buttonClicked event. It is in the ancestor of this event that you would put the code to determine whether or not the clicking of the item is to be allowed.

Argument(s)

Name Script Variable Type Passed By Description
item vs_button String Value Name of the item (button) clicked by the user

Return Values

Value Description
ALLOW (1) Indicates that you want to continue processing and fire the ue_itemClicked event
PREVENT (-1) Indicates that you want to stop the further processing of the button's click

Usage

The ue_itemClicked occurs after this event, assuming that the return value from this event is ALLOW (1).

You should, as a rule, check the AncestorReturnValue for this script to make sure the author hasn't added any logic in the ancestor script that would prevent processing.

This event should never be triggered programmatically, instead use of_clickItem or of_clickButton.

Examples

IF AncestorReturnValue <> ALLOW THEN Return(AncestorReturnValue)

CHOOSE CASE Lower(vs_button)
CASE 'save'
   IF parent.Update() = -1 THEN Return(PREVENT)
END CHOOSE

Return(ALLOW)

See Also

Last edited Jun 24, 2016 at 11:47 AM by cjharris02892, version 14