IliTableHook Class Reference

Table class. More...

#include <ilviews/dataccess/tblhook.h>

Inherited by IliDsUsageHook, IliTableContext, and IliTableGraphicHook.

List of all members.

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.

---

Detailed Description

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.

See also:

IliErrorMessage, IliSchema, IliTable

---

Member Function Documentation

virtual void IliTableHook::cellChanged	(	IlInt	rowno,
		IlInt	colno
	)			[virtual]

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.

Parameters:

	rowno	The row position.
	colno	The column position.

virtual void IliTableHook::columnChanged

(

IlInt

colno

)

[virtual]

Called when a column has changed.

Parameters:

colno

The column position.

virtual void IliTableHook::columnDeleted

(

IlInt

colno

)

[virtual]

Called just after a column has been deleted.

Parameters:

colno

The column position.

virtual void IliTableHook::columnInserted

(

IlInt

colno

)

[virtual]

Called when a new column is inserted.

Parameters:

colno

The column position.

virtual void IliTableHook::columnMoved	(	IlInt	src,
		IlInt	dest
	)			[virtual]

Called just after a column has been moved.

Parameters:

	src	The origin column position.
	dest	The destination column position.

virtual void IliTableHook::columnToBeDeleted

(

IlInt

colno

)

[virtual]

Called just before a column is deleted.

Parameters:

colno

The column position.

virtual void IliTableHook::endOfBatch

(

)

[virtual]

Called to terminate a series of updates to the IliSchema or IliTable objects.

Calls to startOfBatch and endOfBatch may be nested.

virtual void IliTableHook::raiseError

(

const IliErrorMessage &

msg

)

[virtual]

Verbose Called each time an error occurs.

Parameters:

msg

The error message.

virtual void IliTableHook::rowChanged

(

IlInt

rowno

)

[virtual]

Called just after a row has been changed.

Parameters:

rowno

The row position.

virtual void IliTableHook::rowDeleted

(

IlInt

rowno

)

[virtual]

Called just after a row has been deleted.

Parameters:

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.

Parameters:

rowno

The row position.

virtual void IliTableHook::rowInserted

(

IlInt

rowno

)

[virtual]

Called just after a new row has been inserted.

Parameters:

rowno

The row position.

virtual void IliTableHook::rowMoved	(	IlInt	src,
		IlInt	dest
	)			[virtual]

Called just after a row has been moved.

Parameters:

	src	The origin row position.
	dest	The destination row position.

virtual void IliTableHook::rowsExchanged	(	IlInt	rowno1,
		IlInt	rowno2
	)			[virtual]

Called just after a row has been exchanged with another row.

Parameters:

	rowno1	The first row position.
	rowno2	The second row position.

virtual void IliTableHook::rowsFetched	(	IlInt	fromRow,
		IlInt	toRow
	)			[virtual]

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.

Parameters:

	fromRow	The first row position.
	toRow	The last row position (inclusive).

virtual void IliTableHook::rowsInserted	(	IlInt	fromRow,
		IlInt	toRow
	)			[virtual]

Called when many consecutive rows are inserted at once.

By default, this virtual member function repeatedly calls rowInserted with each row index.

Parameters:

	fromRow	The first row.
	toRow	The last row (inclusive).

virtual void IliTableHook::rowToBeChanged

(

IlInt

rowno

)

[virtual]

Called just before a row is changed.

Parameters:

rowno

The row position.

virtual void IliTableHook::rowToBeDeleted

(

IlInt

rowno

)

[virtual]

Called just before a row is deleted.

Parameters:

rowno

The row position.

virtual void IliTableHook::startOfBatch

(

)

[virtual]

Called at the start of a series of updates to the IliSchema or IliTable object.

A call to this virtual member function will be followed by a call to the endOfBatch virtual member function.