class = "form"

This widget displays the GUI form specified in the field's "options" string (form = name). If a data object is already associated with the field, the ascii data associated with the object is parsed and used to initialize the GUI form's fields (see InGuiFromTxt()).

When the "|FormAccept" event is generated, the form is taken down.

Use "InGuiSendForm()" to encode a form's data as an ascii string and to send the string to the form widget's string event handler. The string is assigned to the active field as a VSTRING object. This automatically generates a "|FormAccept" event, causing the form to be taken down.

Typically, InGuiSendForm() would be called from the function associated with the GUI form associated with the form widget -- when the function is invoked with the "V_UiCmdOkay" option.

Use InGuiInqItem() to extract item data from the ascii-encoded string. The functions CdGetItemVal() and CdGetItemInt() are additional utilities for querying and ascii-encoded string of form data.