*Form()

Creates a form.

Syntax

*Form(form_name,"form_label",form_def_name, arg_1, arg_2,, arg_n)

Arguments

form_name: The variable name of the form.; Data type: varname
form_label: The descriptive label of the form.; Data type: label
form_def_name: An existing form definition.; Data type: DefineForm
arg_1, arg_2, ..., arg_n: Arguments being passed into the form.; Data type: user-defined

Example

*DefineForm(frmdef_vehpar, ds)
 *SetRowsCols(6, 5)
 *RowHeight(1, 2)
 *ColumnWidth(1, 20)
 *ColumnWidth(2, 7)
 *ColumnWidth(3, 4)
 *ColumnWidth(4, 20)
 *ColumnWidth(5, 7)
 *ColumnLabel(1, "Properties")
 *ColumnLabel(2, "Values")
 *ColumnLabel(4, "Properties")
 *ColumnLabel(5, "Values")
 *MergeCells(1, 3, 6, 3)
 *SetCell(2, 1, ds.wb.label, , Left, No_Edit)
 *SetCell(3, 1, ds.cf.label, , Left, No_Edit)
 *SetCell(4, 1, ds.br.label, , Left, No_Edit)
 *SetCell(5, 1, ds.tr.label, , Left, No_Edit)
 *SetCell(6, 1, ds.ar.label, , Left, No_Edit)
*EndDefine()
*Form(frm_vehpar, "Vehicle Parameters", frmdef_vehpar, ds_vehpar)

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

Properties

Table 1.
Property	Returns Data Type	Description
label	string	The descriptive label of the form.
state	boolean	Control state (TRUE or FALSE).
varname	string	The variable name of the form.

Comments

A *Form() is a user-defined interface to display and edit data typically defined in a *DataSet().

The number and type of arguments depends on the form.

The layout of the form is defined in a *DefineForm() block.