Control blocks of INPUT ARRAY

Your program can control and monitor the changes made by the user by using control blocks with the INPUT ARRAY statement.

The most commonly used INPUT ARRAY control blocks are:

  • The BEFORE INPUT block - executed one time, before the runtime system gives control to the user. You can implement initialization in this block.
  • The BEFORE ROW block - executed each time the user moves to another row, after the destination row is made the current one.
  • The ON ROW CHANGE block - executed when the user moves to another row after modifications have been made to the current row.
  • The ON CHANGE fieldname block - executed when the cursor leaves a specified field and the value was changed by the user after the field got the focus.
  • The BEFORE INSERT block - executed each time the user inserts a new row in the array, before the new row is created and made the current one.
  • The AFTER INSERT block - executed each time the user inserts a new row in the array, after the new row is created. You can cancel the insert operation with the CANCEL INSERT keywords.
  • The BEFORE DELETE block - executed each time the user deletes a row from the array, before the row is removed from the list. You can cancel the delete operation with the CANCEL DELETE keywords.
  • The AFTER ROW block - executed each time the user moves to another row, before the current row is left. This trigger can also be executed in other situations, such as when you delete a row, or when the user inserts a new row.
  • The BEFORE FIELD block - executes before giving the focus to a cell in the array input.
  • The AFTER FIELD block - executes when leaving a cell in the array input.

For a more detailed explanation of the priority of control blocks see INPUT ARRAY control blocks in the Genero Business Development Language User Guide.