Events
Before Refresh
Enhanced Grid Pro exposes the native APEX Before Refresh event.
Triggered:
- before data in the Grid is reloaded
After Refresh
Enhanced Grid Pro exposes the native APEX After Refresh event.
Triggered on:
- data load (DATA_LOADED)
- new row created (AFTER_CREATE_ROW)
- row refreshed (ROW_REFRESHED)
- successful save (AFTER_SAVE)
Event Data
| Property | Description |
|---|---|
| this.data.action | Information on which action this event was triggered (one of the options above) |
| this.data.offset | From which index data was loaded (only available on DATA_LOADED, AFTER_CREATE_ROW, AFTER_SAVE) |
| this.data.count | How many rows were loaded (only available on DATA_LOADED, AFTER_CREATE_ROW, AFTER_SAVE) |
| this.data.ucGrid | Instance of Grid plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Change
Enhanced Grid Pro exposes the native APEX Change event.
Triggered:
- When the value of a Grid's cell has changed
Note: To add Dynamic Action on change event, please use the following settings:
- Event: Change
- Selection Type: jQuery Selector
- jQuery Selector: .col_COLNAME (example: .col_ENAME)
Explanation: Oracle APEX has a bug that doesn't allow using "Selection Type" = "Column(s)".
Event Data
| Property | Description |
|---|---|
| this.data.changesArr | Array of changes. For each change the following data is provided: row - row index of the edited cell column - column index of the edited cell oldValue newValue |
| this.data.source | String that identifies the source of the change. Examples: edit - normal change of cell's value Autofill.fill - when fill handle was used to change value(s) CopyPaste.paste - when a value was pasted into the cell |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
After save
Enhanced Grid Pro exposes the After Save [UC - Enhanced Grid Pro] event.
Triggered:
- after data is successfully saved (only triggered when there was something to save)
Event Data
| Property | Description |
|---|---|
| this.data.upsertedRows | Data that was inserted/updated. |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Click
Enhanced Grid Pro exposes the Click [UC - Enhanced Grid Pro] event.
Triggered:
- After a Grid's cell has been clicked
Event Data
| Property | Description |
|---|---|
| this.data.row | row index of the cell |
| this.data.column | column index of the cell |
| this.data.triggeringElement | TD element |
| this.data.originalEvent | MouseEvent object |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Cell initialization
Enhanced Grid Pro exposes the Cell Initialization [UC - Enhanced Grid Pro] event.
Triggered:
- After the user enters edit mode in a Grid's cell
Event Data
| Property | Description |
|---|---|
| this.data.row | row index of the cell |
| this.data.column | column index of the cell |
| this.data.triggeringElement | TD element |
| this.data.originalEvent | MouseEvent object |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Cells selection
Enhanced Grid Pro exposes the Cells Selection [UC - Enhanced Grid Pro] event.
Triggered:
- after Grid's cells were selected (one or multiple cells)
Event Data
| Property | Description |
|---|---|
| this.data.rowStart | row index where the selection starts |
| this.data.columnStart | column index where the selection starts |
| this.data.rowEnd | row index where the selection ends |
| this.data.columnEnd | column index where selection ends |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Cell Mouse Over
Enhanced Grid Pro exposes the Cell Mouse Over [UC - Enhanced Grid Pro] event.
Triggered when mouse cursor enters the cell.
Event Data
| Property | Description |
|---|---|
| this.data.row | row index of the cell |
| this.data.column | column index of the cell |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Cell Mouse Out (available from v24.1.1)
Enhanced Grid Pro exposes the Cell Mouse Out [UC - Enhanced Grid Pro] event.
Triggered when mouse cursor leaves the cell.
Event Data
| Property | Description |
|---|---|
| this.data.row | row index of the cell |
| this.data.column | column index of the cell |
| this.data.ucGrid | Instance of the Enhanced Grid Pro plug-in (on which you can call JavaScript functions available - e.g. ucGrid.getValue(...)) |
Cell Highlighting Changed (available from v23.2)
Enhanced Grid Pro exposes the Cell Highlighting Changed [UC - Enhanced Grid Pro] event.
Triggered on:
- One or multiple cells highlighted [HIGHLIGHT_ADD]
- Removed highlighting from one or multiple cells [HIGHLIGHT_REMOVE]
- Removed all highlighting [HIGHLIGHT_REMOVE_ALL]
Event Data
| Property | Description |
|---|---|
| this.data.action | Information on which action this event was triggered (one of the options above) |
| this.data.cells | Affected cells (only available on HIGHLIGHT_ADD, HIGHLIGHT_REMOVE) |
| this.data.cssClass | CSS class used to highlight cells (only available on HIGHLIGHT_ADD) |