Import

[method icon] Import(sControlsDef$)

Import controls

sControlsDef$	String	Definition of controls using syntax from DEF FORM

Applies to: Form

Introduced in KCML version 5.03

Import

string	A string defining the controls to be added to the form

To allow end-users to modify forms directly and have the layout persist, KCML5.03 added a new Import() method which can be called only within the Create() event to pass a partial form definition to the client in a string variable allowing it to modify the form by adding new controls from the definition. This definition is similar to the ASCII representation of a form normally hidden inside the DEFFORM statement.

The definition strings are generated by the EditForm() method which invokes the forms designer in a restricted mode allowing limited control over the forms contents. Any controls predefined for the form by the original programmer are not editable by the user of the edit function. The string returned by Edit() can be saved to disk and recalled when the dynamic form is redisplayed.

See User Editable Forms for more information.