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 at Site Manager -> Development -> Form controls. Form controls have the following properties:

Control display name

The name of the control displayed in the user interface.

Control code name

The name of the control used in 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 files (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 the Development -> Membership, permissions and security -> Custom fields visibility chapter for more details.

Show control in BizForms

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

•	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 - default size of the database column (applies only to the 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 the report parameter field editor.

Page url: http://devnet.kentico.com/docs/5_5r2/devguide/index.html?form_controls_overview.htm