Properties tab

This tab is used to define parameters for the edited form control. The values of these parameters can be set when the control is added to a form, which allows it to be configured to best fit the specific situation. This also means that a control can be reused for fields that require slightly different functionality or design.

The editing interface for the parameter is provided by another form control.

The following actions are possible

•Move up () - moves the parameter up, which also changes its position in the field editor.

•Move down () - moves the parameter down.

•New category () - creates a new category for parameters. The category is displayed as a header in the field editor.

•New attribute () - adds a new parameter.

•Delete item () - deletes the currently selected parameter or category.

When an individual parameter is selected, its properties can be configured:

Please note: Not all options may be available depending on the selected Attribute type.

Database
Column name	The name that will serve as the identifier of the parameter. This name is used in the code of the form control when getting (or setting) the value of the parameter.
Attribute type	Type of value that the parameter should have.
Attribute size	Sets the maximum amount of characters that can be entered into the parameter's field. Only available if the Attribute type is set to Text.
Allow empty value	Enable this if you do not wish the parameter to be checked for empty values.
Default value	Default value of the parameter that will be pre-filled when the current form control is selected.
Display attribute in the editing form	Indicates if the parameter should be available in the Editing control settings section for fields that use the current form control.
Field appearance
Field caption	Sets the text displayed next to the parameter's editing field.
Form control type	Filters the options available in the Form control drop-down list below according to their type.
Form control	Sets the specific form control that should be used to set the value of the parameter.
Field description	Tooltip which will be displayed if a user hovers over the parameter's field.
Has depending fields	Indicates that other parameters may be updated dynamically depending on the value of the given parameter.
Depends on another field	Indicates that the behaviour (e.g. the available selection options) of the given parameter can be affected depending on the value of some other parameter.
Editing control settings
The settings in this section are used to perform additional configuration of the selected Form control, which affects the behaviour or appearance of the field. Please see individual tooltips for more information.
Validation
Regular expression	This regular expression will be used by the validator of the parameter's field. Only available if the selected Attribute type is Text or Long text.
Min/Max length	Sets the minimum/maximum length for entered values. Only available if the selected Attribute type is Text or Long text.
Min/Max value	Sets the minimum/maximum value that can be entered. Only available if the selected Attribute type is numerical.
From/To	Can be used to specify a time interval into which the entered value must belong. Only available if the selected Attribute type is Date and time.
Error message	Error message displayed if a user enters invalid input into the parameter.
CSS styles
Caption style	Used to set CSS styles for the caption of the parameter's field.
Input style	Used to set CSS styles for the input entered into the parameter's field.
Control CSS class	Name of the CSS class used to style the parameter's field.

Any changes to the settings of a parameter must be confirmed by clicking the Save field button at the top.

More resources can be found at:

•Developer's Guide -> Development -> Form controls -> Overview

•Developer's Guide -> Development -> Form controls -> Form control parameters

•Developer's Guide -> Development -> Form controls -> Developing form controls

Help URL: http://devnet.kentico.com/docs/6_0/contexthelp/index.html?properties_form_control.htm