Defined in file: hzDissemino.h
The hdsFormdef or form definition class, defines a set of fields for a form and holds JavaScript that will enable browsers to prevalidate form input. It also states the host data class and form name. Although the hdsFormdef constructor is public, circumstances in which C++ developers would opt for direct creation of hdsFormdef instances are expected to be few. Instead, hdsFormdef instances are generally created by the hdsApp::_readFormDef() function when processing <xformDef> tags in the configs. All hdsFormdef instances are expected to be stored by name in the hdsApp map m_FormDefs. Form names by convention are prepended with 'form_' but this is not enforced by hdsApp::_readFormDef(). Instead form names are required only to be unique. In accordance with the form-class guideline, forms are required to have a host data class. Forms must also have at least one field and one active button and associated form handler. Forms should ideally, also have an abort button but this generally a matter of the form HTML and is not compulsory. For further information please see the synopsis "Dissemino Forms"
Constructors/Detructors
| hdsFormdef* | hdsFormdef | (hdsFormdef&) | |
| hdsFormdef* | hdsFormdef | (void) | |
| Default constructor | hdsFormdef() | Not specified in code. Default applies |
Overloaded operators:
| hdsFormdef& | operator= | (hdsFormdef& op) |
Member Variables:
| hzString | m_DfltAct | Default action (if form handler is not named in the form buttons) | |
| hzString | m_DfltURL | URL of default action (if not supplied with the form buttons) | |
| hzString | m_Formname | Name of form as known to application | |
| hzArray<hdsVE*> | m_VEs | Form visual entities | |
| hzString | m_ValJS | Validation JavaScript (to include functionality for all the buttons) | |
| uint32_t | m_bScriptFlags | Which scripts to include | |
| hzMapS<hzString,hdsField*> | m_mapFlds | All fields in order of name (for checking fields are not duplicated) | |
| uint16_t | m_nActions | Number of form actions (form handlers). | |
| int16_t | m_nReferrals | Set to -1 if form defined within a page or article definition. Otherwise indicates number of references. | |
| hdbClass* | m_pClass | Default class of cache to retrieve objects from | |
| hdsFormdef* | m_pParentForm | This is only set where the hostpage is a response/error page in a form-handler for another form | |
| hzVect<hdsField*> | m_vecFlds | All fields in order of appearance |