ResultCellListener
The ResultCellListener
type describes a function that is used to listen to changes to a ResultCell
in a query's ResultTable
.
(
queries: Queries,
tableId: Id,
rowId: Id,
cellId: Id,
newCell: ResultCell,
oldCell: ResultCell,
getCellChange: GetResultCellChange,
): void
Type | Description | |
---|---|---|
queries | Queries | A reference to the |
tableId | Id | The |
rowId | Id | |
cellId | Id | The |
newCell | ResultCell | The new value of the |
oldCell | ResultCell | The old value of the |
getCellChange | GetResultCellChange | A function that returns information about any |
returns | void | This has no return value. |
A ResultCellListener
is provided when using the addResultCellListener
method. See that method for specific examples.
When called, a ResultCellListener
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 the Id
of ResultCell
that changed. It is also given the new value of the ResultCell
, the old value of the ResultCell
, 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