borland.jbcl Packages borland.jbcl Class Hierarchy borland.jbcl.dataset
java.util.EventListener +----borland.jbcl.dataset.EditListener
Methods
Implemented by EditAdapter
This interface is used as a notification for row editing before and after edit-related operations are completed. This interface includes
With an EditListener, you can
Inserting, adding, and updating methods each have a unique purpose. Insert methods create a new, unposted row, which is equivalent to using the Insert button on the NavigatorControl. The new, unposted row is sometimes called a pseudo-row because it does not exist in the data set until it is posted. Add methods work on newly inserted rows when they are about to be or have been posted. Update methods work on existing rows only, at the time that modifications to them are about to be or have been posted.
void addError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)This is an event to notify listeners when an exception is thrown for row add operations. Call response.abort() (the default) to cause the operation to fail with an appropriate DataSetException or ValidationException. Call response.retry() to cause the operation to be retried. Be sure that the retry will succeed or that your code can handle repeated retries. Call response.ignore() to cause the operation to silently fail without an exception being thrown.
Parameters:
void added(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners that a new row is successfully posted to the DataSet. This event is fired by DataSet.addRow(), which inserts, modifies, and posts a row all in one operation.
Parameters:
void adding(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow newRow)This is an event to notify listeners before a new row is posted to the DataSet. This event is fired by DataSet.addRow(), which inserts, modifies, and posts a row all in one operation. If a VetoException or Exception is thrown inside this method, the post operation is not performed, a ValidationException with an error code of APPLICATION_ERROR is thrown instead. The adding() method is called before checks to make sure all required fields are not null. If a VetoException or Exception is constructed with a STRING parameter, this STRING is used in the default error handling displays (i.e.
throw new VetoException("My error message")
).
Parameters:
void canceling(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners when the editing of a new or existing row in a DataSet is about to be canceled. An application might use this event to save undo information.
Parameters:
void deleteError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)This is an event to notify listeners when an exception is thrown for row delete operations. Call response.abort() (the default) to causes the operation to fail with an appropriate DataSetException or ValidationException. Call response.retry() to cause the operation to be retried. Be sure that the retry will succeed or that your code can handle repeated retries. Call response.ignore() to cause the operation to silently fail without throwing an exception.
Parameters:
void deleted(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners that a successful delete operation has been performed.
Parameters:
void deleting(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners before a row is deleted from the DataSet. If a VetoException or Exception is thrown inside this method, the delete operation is not performed, a ValidationException with an error code of APPLICATION_ERROR is thrown instead. If a VetoException or Exception is constructed with a STRING parameter, this STRING is used in the default error handling displays (i.e.
throw new VetoException("My error message")
).
Parameters:
void editError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.Column column, borland.jbcl.util.Variant value, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)This is an event to notify listeners when any exceptions occur setting a column value. This includes validation check failures as well as any VetoExceptions thrown by a ColumnChangeListener.validating() event handler. The ErrorResponse object allows the user to indicate how the error should be handled. Call response.abort() (the default) to cause the operation to fail with an appropriate DataSetException or ValidationException. Call response.retry() to cause the operation to be retried. Be sure that the retry will succeed or that your code can handle repeated retries. Call response.ignore() to cause the operation to silently fail without an exception being thrown.
Parameters:
void inserted(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners that a new, unposted row is inserted into the DataSet. This event can be used to initialize row values of new rows.
Parameters:
void inserting(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners just before a DataSet attempts to insert a new, unposted row. If a VetoException or Exception is thrown inside this method, the insert operation is not performed, a ValidationException with an error code of APPLICATION_ERROR is thrown instead. If a VetoException or Exception is constructed with a STRING parameter, this STRING is used in the default error handling displays (i.e.
throw new VetoException("My error message")
).
Parameters:
void modifying(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners when a user begins to modify an existing row. If a VetoException or Exception is thrown inside this method, the modify operation is not performed, a ValidationException with an error code of APPLICATION_ERROR is thrown instead. If a VetoException or Exception is constructed with a STRING parameter, this STRING is used in the default error handling displays (i.e.
throw new VetoException("My error message")
).
Parameters:
void updateError(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow row, borland.jbcl.dataset.DataSetException ex, borland.jbcl.util.ErrorResponse response)This is an event to notify listeners when an exception is thrown for row changes. Call response.abort() (the default) to cause the operation to fail with an appropriate DataSetException or ValidationException. Call response.retry() to cause the operation to be retried. Be sure that the retry will succeed or that your code can handle repeated retries. Call response.ignore() to cause the operation to silently fail without an exception being thrown.
Parameters:
void updated(borland.jbcl.dataset.DataSet dataSet)This is an event to notify listeners that a modified row has been successfully posted to a DataSet.
Parameters:
void updating(borland.jbcl.dataset.DataSet dataSet, borland.jbcl.dataset.ReadWriteRow newRow, borland.jbcl.dataset.ReadRow oldRow)This is an event to notify listeners before a modified row is posted to the DataSet. If an exception is thrown inside this method, the post operation is not performed, a ValidationException with an error code of APPLICATION_ERROR is thrown instead. The updating() method is called before checks to make sure all required fields are not null. If a VetoException or Exception is constructed with a STRING parameter, this STRING is used in the default error handling displays (i.e.
throw new VetoException("My error message")
).
Parameters: