Language Reference Guide : 5. Events : UnSelect Event
 
Share this page                  
UnSelect Event
The UnSelect event is triggered when the user unselects a field that has a select bias or when the IsSelected attribute for the form field is set to FALSE. This event is triggered after the field is unselected.
This event has the following syntax:
on unselect [fieldname]
fieldname is optional if you specify the event block in a field script.
The following attributes of the FrameExec class can be used in the UnSelect event block:
TriggerField
Specifies the field with a select bias that was unselected
OriginatorField
Specifies the field specified in the initial on unselect statement
SelectedList
Specifies the set of currently selected fields in the frame
Use the CurFrame system variable to access these attributes. For more information, see FrameExec Class.
Usage: The UnSelect event is defined for all form fields. This event cannot be specified for menu fields.
This event is triggered for a field even if the field is unselected as part of a group unselect.
The UnSelect event indicates that the user has unselected a field. This event is used only with a single field. The event is useful if unselection of a particular field must trigger specific event code.
Because this event deals only with a single field, you may prefer to place the fields in a composite field and specify the ChildUnSelect event on that composite field. This triggers the ChildUnSelect event when any child field is unselected. If you are only interested in the SelectedList, and not in what triggered the event, use the SelectionChanged Event.
More information:
OriginatorField Attribute
SelectedList Attribute
TriggerField Attribute