Widget Class: _isModified

Widget Class: _isModified

Reports whether a widget is modified

Syntax
Details

Syntax

objectName._isModified( isModified );

Argument Type Use Description

isModified Numeric Output returns a value indicating whether the widget is modified: 1 is modified, 0 is not modified

Argument	Type	Use	Description
isModified	Numeric	Output	returns a value indicating whether the widget is modified: 1 is modified, 0 is not modified

Details

A widget is modified when users change its field contents or select it with the keyboard keys or mouse.
When a widget is modified, its status returns to unmodified after the widget label, the _select method, and the MAIN section execute.
The field or modified function can also return the modified status of a widget, but the _isModified method is the only way to determine if a widget is modified from a different entry such as a method.
In general, the _isModified method is not needed because a widget's label runs when the widget is modified.

Example

_isModified determines whether update is modified:

update._isModified('isModified');
if isModified then
   put 'the UPDATE button is modified';
else
   put 'the UPDATE button is not modified';

Chapter Contents
Previous
Next
Top of Page