Dispatched whenever an update pertaining to an item in the NonVisualTable reaches the client.
It reports all the new and old values of the fields, though it does not allow
you to alter the values received from the Server.
If the involved table behaves with a "COMMAND logic", then the old
values for the current update are meant as relative to the same key.
Moreover, if the involved table behaves in "MultiMetapush logic",
then each update may be associated with either a first-level or
a second-level item. In this case, the reported fields are always the union
of the first-level and second-level fields and each single update can
only change either the first-level or the second-level fields
(but for the "command" field, which is first-level and is always set to
"UPDATE" upon a second-level update); note that the second-level field
values are always null until the first second-level update occurs).
With "MultiMetapush logic" behaviour, in all methods where a field
descriptor has to be supplied, the following convention should be followed:
- The field name can always be used, both for the first-level and the
second-level fields (of course, unless schema identifiers were used as
schema descriptors for the related table). Only in case of name conflict,
the second-level field name must be preceded by a "$" character.
- The field position can always be used; however, the field positions
for the second-level fields start at the highest position of the
first-level schema + 1. If schema identifiers were used as schema
descriptors for the related table, client-side knowledge of the
first-level schema lenght would be required.
public function getFieldValue(field:*):*
Inquiry method that gets the new value for a specified field, as received from the Server with the current update or "UNCHANGED" if the field is not changed.
Parameters
| field:* — String field name or a Number representing a field position.
|
Returns
| * — "UNCHANGED" if the value is unchanged, the received value otherwise. TODO
|
public function getNumFields():uint
Inquiry method that gets the number of fields received from the Server
with the current update. The value, however, is the same across all
updates pertaining to the same item, because it is determined by the
schema associated to the item at subscription.
The fields received from the Server are always associated to consecutive
field numbers starting from 1.
Only in case the related data table behaves in "MultiMetapush logic",
it may not be possible to determine the correct number of fields of the
data table. This only happens when a schema identifier is used as the
schema descriptor for the second-level schema and no update for any
second-level item has been received yet.
Returns
| uint — The number of fields received from the Server, or 0 if the
total number of fields cannot be determined (see above).
|
public function getOldFieldValue(field:*):*
TODO commento
Parameters
Returns
public function isFieldChanged(field:*):Boolean
Inquiry method that asks whether the value for a field is changed after the reception of an update from the Server for an item.
Parameters
| field:* — String field name or a Number representing a field position.
|
Returns
| Boolean — true if the value is changed; false otherwise.
|
public static const NON_VISUAL_ITEM_UPDATE:String = "nonVisualItemUpdate"
Define the value of the type property of a NonVisualItemUpdate event object.
Lightstreamer Flex client 1.1 API
TableItemEvent 
Hide Inherited Public Properties
Show Inherited Public Properties