Add Button Processing

Normally, the user does not select a row before an add action, but if a row is highlighted, the system updates the GC values to reflect the selected row values. The system does not update the database just because the user clicks the row.

The engine pauses for the Button Clicked event to be processed. At this point, the runtime structures have these values:

  • BC = Values from the database (from the last record read).

  • FC = Values from the database (if the field is a database field).

  • GC = Values from the database (from the selected row).

  • FI = Values passed from a calling form (if any).

  • PO = Values passed from POs.

Because this is an add action, the content of GC is irrelevant at this point. BC and GC do not contain the same values.

This diagram illustrates the information that is in the runtime structures just before the system fires Button Clicked:

Content of runtime structures before Button Clicked for Add Button fires

You typically use the Button Clicked event for the Add button to interconnect to another form, such as a fix/inspect or headerless detail form on which the system actually performs the add action.