borland Packages Class Hierarchy dx.dataset Package
java.util.EventListener +----com.borland.dx.dataset.ColumnChangeListener
Methods
Implemented by DBEventMonitor, ColumnChangeAdapter
This interface is used for notification that data has changed in a column. One listener can be written for each column, or for an entire StorageDataSet
, for which you want to be notified of changes. This is the listener to use for checks on field values that should be done before a user leaves the field. One example of when this might be useful is to check that a part number is in stock before the rest of the line item information is entered. Writing a listener for a StorageDataSet
enables it to be called for all columns.
void changed(DataSet dataSet, Column column, Variant value)Called after all column level validations have been performed and a column value has been successfully posted inside a
ReadWriteRow
.
dataSet
column
value
void validate(DataSet dataSet, Column column, Variant value)Called before column level validations like
readOnly
, min
, or max
are performed, and before the new value is recorded in a ReadWriteRow
. Note that if values are set programmatically, EditMask
constraints are not applied. You can change the value stored in value
, but it must still pass the column level validations. To prevent the value from being set, throw an Exception
. If an Exception
is constructed with a String
parameter, this String
is used in the default error handling display, for example,
throw new Exception("My error message");
dataSet
column
value