Article Details
Id:14192
Product:finPOWER Connect
Type:NEW
Version:3.00.03
Opened:26/06/2014
Closed:07/11/2016
Released:01/12/2016
Job: J013532
High Importance

Page Sets; new events and properties to handle Enter/ Leave events

New events and properties have been added to Page Set objects to handle Enter/ Leave events. This allows more flexibility when handling the Change event - rather than updating the page whenever the object changes you can defer this until the focus leaves the object.

New "Enter" and "Leave" events have been added to ComboBox, DBComboBox, DateBox, DateCycleComboBox, HtmlEditor, NumberBox and TextBox Page Objects.

In addition these Page Objects include a "TextOriginal" (or "ValueOriginal") and "Changed" properties.

The Original Text/ Value is saved before the "Enter" event is called. This property can be amended at any stage, including whilst in the "Enter" event.

Note, the "Changed" property simply checks whether then original Text/ Value is different from the current Text/ Value.

The "Change" event has a very important event argument "ChangeHandled". If you handle the change in this event you should set "ChangeHandled" to True. This will update the original Text/ Value to the current Text/ Value and therefore the object's "Changed" will be False.