Rogue Wave Views 5.5.1 |
Rogue Wave Views |
Rogue Wave Views Documentation Home |
Table class. More...
#include <ilviews/dataccess/tblhook.h>
Inherited by IliDsUsageHook, IliTableContext, and IliTableGraphicHook.
Public Member Functions | |
IliTableHook () | |
This constructor creates a table hook. | |
virtual void | allRowsDeleted () |
Called when the IliTable::clearRows member function is called. | |
virtual void | cellChanged (IlInt rowno, IlInt colno) |
Called just after the cell has changed. | |
virtual void | columnChanged (IlInt colno) |
Called when a column has changed. | |
virtual void | columnDeleted (IlInt colno) |
Called just after a column has been deleted. | |
virtual void | columnInserted (IlInt colno) |
Called when a new column is inserted. | |
virtual void | columnMoved (IlInt src, IlInt dest) |
Called just after a column has been moved. | |
virtual void | columnToBeDeleted (IlInt colno) |
Called just before a column is deleted. | |
virtual void | endOfBatch () |
Called to terminate a series of updates to the IliSchema or IliTable objects. | |
virtual void | raiseError (const IliErrorMessage &msg) |
Verbose Called each time an error occurs. | |
virtual void | rowChanged (IlInt rowno) |
Called just after a row has been changed. | |
virtual void | rowDeleted (IlInt rowno) |
Called just after a row has been deleted. | |
virtual void | rowFetched (IlInt rowno) |
Called just after a new row has been fetched from a remote database and inserted. | |
virtual void | rowInserted (IlInt rowno) |
Called just after a new row has been inserted. | |
virtual void | rowMoved (IlInt src, IlInt dest) |
Called just after a row has been moved. | |
virtual void | rowsExchanged (IlInt rowno1, IlInt rowno2) |
Called just after a row has been exchanged with another row. | |
virtual void | rowsFetched (IlInt fromRow, IlInt toRow) |
Called when many consecutive rows are fetched at once. | |
virtual void | rowsInserted (IlInt fromRow, IlInt toRow) |
Called when many consecutive rows are inserted at once. | |
virtual void | rowToBeChanged (IlInt rowno) |
Called just before a row is changed. | |
virtual void | rowToBeDeleted (IlInt rowno) |
Called just before a row is deleted. | |
virtual void | startOfBatch () |
Called at the start of a series of updates to the IliSchema or IliTable object. | |
virtual void | tableChanged () |
Called when the object has undergone a significant number of changes (see the description for the IliTable::tableChanged member function.). | |
virtual void | tableDeleted () |
Called when the IliSchema or IliTable object is deleted. |
Table class.
Library: dataccess
The IliTableHook
class can be used to monitor updates undergone by instances of the IliSchema
or IliTable
classes (or of their subclasses). The IliSchema::addHook
member function installs a table hook. To install a hook on a table or schema object, you first define a subclass of the IliTableHook
class, and override some, or all of its virtual member functions. Instances of this new class can then be created and added to the table or schema object. Be aware that the virtual member functions of a table hook are called in very specific contexts that are elaborated in the description of each member function. Consequently, great care should be taken not to call, directly or indirectly, other member functions on the underlying table that would completely change the context in which the member function was called. For example, you should not call the IliTable::deleteRow
member function from inside a rowFetched
table hook virtual member function.
Called just after the cell has changed.
If more than one value has changed in a row, it is likely that the rowChanged
member function will be called, instead of this member function.
rowno | The row position. | |
colno | The column position. |
virtual void IliTableHook::columnChanged | ( | IlInt | colno | ) | [virtual] |
Called when a column has changed.
colno | The column position. |
virtual void IliTableHook::columnDeleted | ( | IlInt | colno | ) | [virtual] |
Called just after a column has been deleted.
colno | The column position. |
virtual void IliTableHook::columnInserted | ( | IlInt | colno | ) | [virtual] |
Called when a new column is inserted.
colno | The column position. |
Called just after a column has been moved.
src | The origin column position. | |
dest | The destination column position. |
virtual void IliTableHook::columnToBeDeleted | ( | IlInt | colno | ) | [virtual] |
Called just before a column is deleted.
colno | The column position. |
virtual void IliTableHook::endOfBatch | ( | ) | [virtual] |
virtual void IliTableHook::raiseError | ( | const IliErrorMessage & | msg | ) | [virtual] |
Verbose Called each time an error occurs.
msg | The error message. |
virtual void IliTableHook::rowChanged | ( | IlInt | rowno | ) | [virtual] |
Called just after a row has been changed.
rowno | The row position. |
virtual void IliTableHook::rowDeleted | ( | IlInt | rowno | ) | [virtual] |
Called just after a row has been deleted.
rowno | The row position. |
virtual void IliTableHook::rowFetched | ( | IlInt | rowno | ) | [virtual] |
Called just after a new row has been fetched from a remote database and inserted.
In this case, the rowInserted
member function will also be called.
rowno | The row position. |
virtual void IliTableHook::rowInserted | ( | IlInt | rowno | ) | [virtual] |
Called just after a new row has been inserted.
rowno | The row position. |
Called just after a row has been moved.
src | The origin row position. | |
dest | The destination row position. |
Called just after a row has been exchanged with another row.
rowno1 | The first row position. | |
rowno2 | The second row position. |
Called when many consecutive rows are fetched at once.
By default, this virtual member function repeatedly calls rowFetched
with each index between fromRow
and toRow
.
fromRow | The first row position. | |
toRow | The last row position (inclusive). |
Called when many consecutive rows are inserted at once.
By default, this virtual member function repeatedly calls rowInserted
with each row index.
fromRow | The first row. | |
toRow | The last row (inclusive). |
virtual void IliTableHook::rowToBeChanged | ( | IlInt | rowno | ) | [virtual] |
Called just before a row is changed.
rowno | The row position. |
virtual void IliTableHook::rowToBeDeleted | ( | IlInt | rowno | ) | [virtual] |
Called just before a row is deleted.
rowno | The row position. |
© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.