Form controls overview

Form controls allow you to use custom field types in editing forms that are based on Kentico FormEngine. These include:
 

Document editing forms (Form tab)
Web part properties
BizForms
Forms using system tables defined in Site manager -> Development -> System tables
Forms using custom tables defined in Site manager -> Development -> Custom tables
Report parameters

 

Form controls are standard ASCX controls that inherit from the CMS.FormControls.FormEngineUserControl class.

 

Managing form controls

 

You can register form controls in the catalog in Site Manager -> Development -> Form controls. The form controls have the following properties:

 

Control display name

The name of the control displayed to the users.

Control code name

The name of the control used in the code.

Control file name

Relative path to the ASCX control starting from

/CMSFormControls folder.

 

Example:

countryselection.ascx

Use control for text

Indicates if the control can be used for text values.

Use control for long text

Indicates if the control can be used for long text values.

Use control for integer

Indicates if the control can be used for integer values.

Use control for decimal

Indicates if the control can be used for decimal values.

Use control for date-time

Indicates if the control can be used for date-time values.

Use control for boolean

Indicates if the control can be used for boolean (bit) values.

Use control for file

Indicates if the control can be used for file (attachments).

Use control for GUID

Indicates if the control can be used for GUID values.

Use control for visibility

Indicates if the control can be used as a field visibility control. See this chapter for more details.

Show control in BizForms

Indicates if the control should be offered among field types in the simplified mode in BizForms module. If you enable this box, you also need to enter the following values:

 

Default data type - the type of the field that will be used by default when the user chooses to create a new field with this field type.
 
Column size - default size of the database column (applies only to Text data type).

Show control in document types

Indicates if the control should be offered among field types in the document types field editor.

Show control in system tables

Indicates if the control should be offered among field types in the system tables field editor.

Show control in custom tables

Indicates if the control should be offered among field types in the custom tables field editor.

Show control in controls (web parts and inline controls)

Indicates if the control should be offered among field types in the web part property editor.

Show control in reports

Indicates if the control should be offered among field types in report parameters field editor.