List of predefined actions

Table 1. Automatic actions (automatically created by dialogs)
Action Name Description ON ACTION block is required Context
accept Validates the current interactive instruction (singular dialogs only) can overwrite (1)
cancel Cancels the current interactive instruction (singular dialogs only) can overwrite (1)
close Triggers a cancel key in the current interactive instruction (by default) can overwrite (7)
insert Inserts a new row before current row can overwrite (2)
append Appends a new row at the end of the list can overwrite (2)
delete Deletes the current row can overwrite (2)
find Opens the fglfind dialog window to let the user enter a search value, and seeks to the row matching the value can overwrite (4)
findnext Seeks to the next row matching the value entered during the fglfind dialog can overwrite (4)
nextrow Moves to the next row (only if list using one flat screen record) can overwrite (8)
prevrow Moves to the previous row (only if list using one flat screen record) can overwrite (8)
firstrow Moves to the first row (only if list using one flat screen record) can overwrite (8)
lastrow Moves to the last row (only if list using one flat screen record) can overwrite (8)
help Shows the help topic defined by the HELP clause can overwrite (1)
editcopy Copy selected rows (or current row if MRS is off) to the clipboard can overwrite (9)
Table 2. Special actions (special behavior)
Special Action Name Description ON ACTION block is required Context
browser_back Sent when the user hits the back button in a web browser (web front-end only). yes (7)
browser_forward Sent when the user hits the forward button in a web browser (web front-end only). yes (7)
dialogtouched Sent by the front end each time the user modifies the value of a field. For more details, see Immediate detection of user changes. yes (7)
interrupt Sends an interruption request to the program when processing. For more details, see User interruption handling. no (5)
windowresized On Mobile devices, this action is sent when changing the orientation of the device. On other front-ends, it is sent when the current active window is resized. For more details, see Adapting to viewport changes. yes (6)
notificationpushed On Mobile devices, this action is fired when receiving a push notification message. See getRemoteNotifications yes (6)
Table 3. Local actions (handled by the front end)
Local Action Name Description ON ACTION block is required Context
editcopy Copies the current selected text to the clipboard can overwrite (7)
editcut Copies the current selected text to the clipboard and removes the text from the current input widget can overwrite (7)
editpaste Pastes the clipboard content to the current input widget can overwrite (7)
nextfield Moves to the next field in the form can overwrite (3)
prevfield Moves to the previous field in the form can overwrite (3)
nextrow Moves to the next row in the list can overwrite (4)
prevrow Moves to the previous row in the list can overwrite (4)
firstrow Moves to the first row in the list can overwrite (4)
lastrow Moves to the last row in the list can overwrite (4)
nextpage Moves to the next page in the list can overwrite (4)
prevpage Moves to the previous page in the list can overwrite (4)
nexttab Moves to the next page in the folder can overwrite (6)
prevtab Moves to the previous page in the folder can overwrite (6)

Context column descriptions

  1. CONSTRUCT, INPUT, PROMPT, INPUT ARRAY and DISPLAY ARRAY.
  2. INPUT ARRAY only.
  3. CONSTRUCT, INPUT and INPUT ARRAY.
  4. INPUT ARRAY and DISPLAY ARRAY.
  5. Only possible when no interactive instruction is active.
  6. Possible in any kind of interactive instruction (MENU included).
  7. DIALOG, CONSTRUCT, INPUT, PROMPT, INPUT ARRAY and DISPLAY ARRAY.
  8. INPUT ARRAY and DISPLAY ARRAY on flat screen-record.
  9. DISPLAY ARRAY only.