|
||
The following properties can be entered when editing a form control on the General tab:
Display name |
Sets the name of the form control used in the interface, e.g. when selecting a control in a field editor. |
Code name |
Sets the name of the control that is used as its unique identifier in code. |
Type |
Allows the selection of the category under which the form control will be placed. The type can be used to filter form controls in the field editor. |
File name |
Contains the relative path to the .ascx file that implements the form control.
Example: ~/CMSFormControls/Basic/TextBoxControl.ascx |
The properties under this section are used to set for which attribute types the form control should be available. Possible attribute types for fields include standard data types (Text, Long text, Decimal, Integer, Long integer, Boolean, Date-time), as well as the following:
Visibility |
This attribute type is used for controls that modify the visibility options of other fields.
Please see the Development -> Membership, permissions and security -> Custom field visibility chapter in the Developer's Guide for more details. |
Unique identifier (GUID) |
Attributes of this type are 32‑character strings used as globally unique identifiers for objects. |
File |
Used for fields that provide file management. |
Document attachments |
This attribute type is used for fields that allow the management of document attachments. |
This section of properties is used to specify in which forms the control can be used i.e. where in the user interface it can be selected. The following options are available:
Document types |
Allows use in document type fields, which can be edited in Site Manager -> Development -> Document types. The actual form is displayed when editing a document on the Form tab in CMS Desk -> Content -> Edit. |
Custom tables |
Allows the control in custom table fields, which can be edited in Site Manager -> Development -> Custom tables. The corresponding data editing form can be found in CMS Desk -> Tools -> Custom tables. |
System tables |
Allows use in system table fields, which can be edited in Site Manager -> Development -> System tables. The editing forms of system objects are located in various sections of the administration interface or on the live site, depending on the specific object. |
Reports |
If checked, the control may be used to provide the interface for entering report parameters, which can be defined when editing a report in CMS Desk -> Tools -> Reporting. The reporting parameter form is displayed when a report is viewed in the interface or published on the live site. |
Controls and web parts |
Allows the control to be used for the properties of web parts and widgets, as defined in Site Manager -> Development -> Web parts/Widgets. This editing form provides the configuration dialog of individual web parts or widget instances. |
Forms |
If checked, the control may be used to represent fields of forms, which can be edited in CMS Desk -> Tools -> Forms. If you allow a form control for forms, you also need to enter the following default values that will be used if the field is edited in simple mode:
•Default data type - the data type of the field that will be used by default when a user chooses to create a new field of this type. •Column size - only applies to the Text data type. This sets the maximum size of the database column used to store the field, which also limits amount of characters that may be entered into the field. |
More resources can be found at:
•Developer's Guide -> Development -> Form controls -> Overview
•Developer's Guide -> Development -> Form controls -> Developing form controls