TinyBase logoTinyBase

ResultRowListener

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

(
  queries: Queries,
  tableId: Id,
  rowId: 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.

rowIdId

The Id of the ResultRow that changed.

getCellChangeGetResultCellChange

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

returnsvoid

This has no return value.

A ResultRowListener is provided when using the addResultRowListener method. See that method for specific examples.

When called, a ResultRowListener is given a reference to the Queries object, the Id of the ResultTable that changed (which is the same as the query Id), the Id of the ResultRow that changed, 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