VS.1.4  event

User interactions with editable tables, Input components, and Selection compo­nents automatically re-execute the Views­heet onLoad handler.

The event object can be used within an onLoad Handler script to provide information about the user's most recent action in editable Tables, Input Components, and Selection Components (Selection List, Selection Tree, Range Slider, Calendar). The event object is instantiated at runtime when a user makes an interaction of the appropriate type, so you should test for its existence before attempting to access its properties. For example:

if(event!=null) {

   // access 'event' properties, such as...

   // event.name, event.type, event.source, etc.

}

For an editable Table, the event object provides the following properties:

event.name

The name of the table component.

event.type

The type of the component, always 'table'.

event.row

The index of the row in the table which the user modified.

event.column

The index of the column in the table which the user modified.

event.source

A reference to the table object which can be used to access table properties.

For an Input component or Selection component, the event object provides the following properties:

event.name

The name of the component, e.g., “SelectionList1”

event.type

The type of the component: 'radiobutton', 'checkbox', 'combobox', 'textinput', 'selectionlist', 'selectiontree', 'rangeslider', 'calendar'

event.source

A reference to the component which can be used to access component properties, e.g., event.source.title='New Title'.

See Also

Accessing the Most Recent User Modification, for additional discussion of 'event' object.

<< VS.1.3 pviewsheet © 1996-2013 InetSoft Technology Corporation (v11.5) VS.1.5 runQuery >>