OnExpandRow Event
Description
This event fires when the user clicks the icon to expand a row in the Grid.
Discussion
This event ONLY fires if you have set the 'Row expander type' to 'CustomEvent'.
The following variables are available to you in the event:
- Variable
- Description
- e.tmpl
The grid component definition
- e.rowNumber
The row number of the row that was expanded (numeric value)
- e.primaryKeyValuesArray
An array of the primary key values for the row that was expanded. All values in this array are character values, even if the corresponding primary key column is of a different type.
This event must set the e.html and e.javascript properties. The contents of the expanded row will be set to e.html. In addition, if e.javascript is not null, the javascript contained in this property will be executed.
- Property
- Description
- e.htmlPrefix
The HTML markup that you want to add before the Detail View is rendered. Must be wrapped in <td>...</td> tags.
- e.htmlSuffix
The HTML markup that you want to add after the Detail View is rendered. Must be wrapped in <td>...</td> tags.
- e.javascript
(optional) Any Javascript that you want to execute
Example
e.html = "this text will be inserted in the row when it is expanded" e.javascript = "alert('Row was expanded');"
Setting State Variables
You can also set state variables in this event. The value of any state variables will be available in all subsequent ajax callbacks (in the e.__si2 object).
To set a state variable:
e._state.myvar1 = "value1" e._state.myvar2 = "value2"