resetFirstChange

resetFirstChange();

The resetFirstChange method of the Form class resets the first change status of the referenced form and all TextBox, JadeRichText, and JadeEditMask controls on the form. After calling the resetFirstChange method, the next change made to a control on the form listed in the following table again generates a firstChange event for the form.

Control Class	Change
TextBox	Change to the value of the text property
JadeEditMask	Change to the value of the text property
JadeRichText	After a user change but before the change event (same rules as those that apply to the JadeRichText class firstChange event)
CheckBox	Change to the value of the value property
OptionButton	Change to the value of the value property
ComboBox	Different entry selected (this does not apply to the text box portion of the combo box unless the text property change causes a different list entry to be selected)
ListBox	Different list entry selected
Table	Cell updated by the Control class automaticCellControl property, including default inputType property entry of CheckBox, TextBox, JadeEditMask, and ComboBox controls (but not when a different row or column is selected)

Similarly, the next change made on each TextBox, JadeRichText, and JadeEditMask control on the form again generates a firstChange event on that control.

The resetFirstChange method of the Control class resets the first change status of the control and all children of the control. As only the TextBox, JadeRichText, and JadeEditMask controls have a firstChange event, all other controls ignore the method other than to call the method on any children. The code fragment in the following example resets the firstChange event status on the text box.

textBox1.resetFirstChange();

The code fragment in the following example ignores the method for the group box, but resets the firstChange event status for any child (or children of children) TextBox, JadeRichText, or JadeEditMask controls.

grpAddress.resetFirstChange();

You could use the resetFirstChange method, for example, so that when a user clicks an update button and the logic associated with that button performs the required updating, the form remains active. Calling resetFirstChange will reset the firstChange status of the form and its controls to the same state as when the form was loaded. The next change made to a control on the form and to any TextBox, JadeRichText, and JadeEditMask controls on that form again generates a firstChange event and therefore signals that a new change has been made to the data. (To accomplish this for TextBox, JadeRichText, and JadeEditMask controls without calling the resetFirstChange method, you must use logic to reset the text of all of those controls.)