Parameters are passed to called forms by means of a parameter List. A parameter List is a named programmatic construct that is simply a List of parameter names (called keys) and their values.
You can pass parameter values to forms invoked by the Built-in subprograms CALL_FORM, OPEN_FORM, and NEW_FORM. In addition, you can pass parameter values to Graphics with the RUN_PRODUCT procedure.
A parameter you include in a parameter List can be either a text parameter or a data parameter. The parameter type determines how its value is interpreted.
The value of a text parameter being passed to a called product is a CHAR string that can represent the following:
The value of a data parameter being passed to a called product is always the name of a record group defined in the current form. (A record group is a data structure that stores records derived from a query or through programmatic assignment.) Data parameters are used to pass data to Graphics invoked with the RUN_PRODUCT Built-in subprogram.
You cannot pass data parameters to forms.
The following table shows the structure of a parameter List that contains four parameters:
Key |
Paramtype |
Value |
---|---|---|
CITY |
Text_Parameter |
'BOGOTA' |
CATEGORY |
Text_Parameter |
'EXPORTS' |
MULTIPLIER |
Text_Parameter |
'.0275' |
NEW_DATA |
Data_Parameter |
'RECORD_GROUP8' |