TinyBase logoTinyBase

ResultTableListener

The ResultTableListener type describes a function that is used to listen to changes to a query's ResultTable.

(
  queries: Queries,
  tableId: Id,
  getCellChange: GetResultCellChange,
): void
TypeDescription
queriesQueries

A reference to the Queries object that changed.

tableIdId

The Id of the ResultTable that changed, which is also the query Id.

getCellChangeGetResultCellChange

A function that returns information about any ResultCell's changes.

returnsvoid

This has no return value.

A ResultTableListener is provided when using the addResultTableListener method. See that method for specific examples.

When called, a ResultTableListener is given a reference to the Queries object, the Id of the ResultTable that changed (which is the same as the query Id), and a GetResultCellChange function that can be used to query ResultCell values before and after the change.

You can create new query definitions within the body of this listener, though obviously be aware of the possible cascading effects of doing so.

Since

v2.0.0