An instance of GroupEvent represents a change on a BPM Object
Group attribute, triggered from a Presentation.
Group attributes of an object are represented by array fields on a Presentation
screen. When the user interacts with arrays, GroupEvents are
generated.
Methods that are defined as Event Listener for Presentation arrays receive
an argument of type GroupEvent.
An instance of
GroupEvent carries information about a change
made to the group attribute associated with the Presentation array. The
GroupEvent.indexes attribute holds a list of the elements that are affected by the
event (row numbers being at
0). The
GroupEvent.id
attribute indicates the type of change that triggered the event. The
GroupEvent component defines the
following type of events, which are the possible values
GroupEvent.id can take:
- GroupEvent.ADD: Generated when a user clicks the + button on the
array toolbar. This event appends a row at the end of a group. For this type of
event, the GroupEvent.indexes attribute is null.
- GroupEvent.INSERT_DOWN: Generated when a user selects a row, then clicks the Insert
Down button on the array toolbar. This event inserts a row below the selected
row or group of rows.
- GroupEvent.INSERT_UP: Generated when a user selects a row, then clicks the Insert Up
button on the array toolbar. This event inserts a row above the selected row or
group of rows.
- GroupEvent.REMOVE: Generated when a user selects a row, then clicks the Remove button
on the array toolbar. This event removes the selected row or group of rows.
- GroupEvent.REMOVE_LAST: Generated when a user clicks the - button on the array toolbar.
This event removes a row from the end of a group. For this type of
event, the GroupEvent.indexes attribute is null.