Data Source Events

Previous Next

This list contains USoft-specific events that occur in the context of data source objects.

The -pre- events are mainly used to prevent, under specific circumstances, that the operation is executed. The -post- events are mainly used to add custom processing to the operation.

If the operation(s) you are coding is (are) closely associated with a UI control, you may prefer to add these events to a control associated with the data source, rather than to the data source object itself. This has advantages for code maintainability. In this case, the control will propagate the event handling to the data source. The effect will be the same in both cases, except that any occurrence of the 'this' keyword will refer to the UI control in one case and to the data source in the other.

Event

Occurs when

beforecleardataset

Before a dataset is cleared.

beforeexecutequery

Before the data source is queried. See also the before... and rowpre... events help topic.

 

In default applications, users can query by pressing the Search button. To query programmatically, use the executeQuery() function of the DataSourceContainer object.

beforegotodataset

When navigation to a different dataset takes place. See also the before... and rowpre... events help topic.

 

In default applications, users can navigate to a different dataset using the special DataSetNumbers control offered in each data page. To navigate programmatically, call the gotoDataSet() function of the DataSourceContainer object.

beforerefresh

Before the data source is refreshed. See also the before... and rowpre... events help topic.

 

To refresh the data source programmatically, call the refresh() function of the DataSourceContainer object.

colpreupdate

Before a value in a column is updated.

colpostupdate

After a value in a column is updated.

dataset

When data is received for one or more data sources.

ongetdataset

This event has been replaced by the dataset event and is supported for backward compatibility only.

onselectrow

This event has been replaced by the rowselect event and is supported for backward compatibility only.

rowpostcreate

After a record is created.

rowpostdelete

After a record is deleted.

rowpostrefresh

After a record is refreshed.

rowpostselect

After a record is selected (whether or not selection was successful).

rowpostupdate

After a record is updated.

rowprecreate

Before a record is created. See also the before... and rowpre... events help topic.

rowpredelete

Before a record is deleted. See also the before... and rowpre... events help topic.

rowprerefresh

Before a record is refreshed. See also the before... and rowpre... events help topic.

rowpreselect

After the currently selected record has changed, and before selection happens. See also the before... and rowpre... events help topic.

rowpreupdate

Before a record is updated. See also the before... and rowpre... events help topic.

rowquery

Before row selection changes to a different row.

rowselect

When the currently selected row changes.

showdata

Notifies controls on the page that new data is available for display. This event is for advanced developers who are creating control factories.

 

See Also

Top-level Events

Control Events

Custom events