Form Controls

What is a command bar?
What is a button?
What is a label?

What is a radio button?
What is a text box?
What is a selection field?
What is a picture field?
What is a separator?
What is a managed form table?
What is a checkbox?
What is a spreadsheet document field?
What is an HTML document field?
What is a formatted document field?

Command bar

A form can contain command bar controls. Each command bar is a set of commands applicable only to this form or to a certain part of the form. Actions involved in working with a command bar are similar to the standard actions used in MS Windows.


Buttons in a form are used to perform some actions specified by the form algorithm. An action is triggered after a button is clicked (for example, with a mouse pointer).

One button in a form may serve as a default, and it can be either clicked with the mouse or with the keyboard shortcut Ctrl + Enter.

For some buttons, other keyboard shortcuts may be provided that enable the user to select them without using the mouse and without reaching it by tabbing through the form controls.

Some buttons can be of the Submenu type (they contain actions and separators). Such buttons contain a special icon shaped as an inverted triangle. Clicking such a button will open a drop-down menu. The list of commands is determined during configuration development.

If a button has a vertical separator along with the icon, clicking the button itself will execute the action specified for the button. Clicking the part with the triangle will open a drop-down menu.


The Label control is designed to include various explanatory captions in a form.

A form may contain labels that are hyperlinks. When you mouse over such a form element, the cursor will change to a hand while underlining will be applied to the text. Such items are used to perform certain actions, in a way similar to buttons (for example, to open other forms). A hyperlink is selected in the standard manner.

A label can be displayed as a marquee.

A label can contain a picture.


The panel control is designed to place a large number of other controls (including panels) within the limited space of a form. It allows you to logically consolidate information related to a particular section. The controls display may vary depending on user actions.

Radio button

The radio button form control is intended to select one of several possible values. To select a value of a radio button, click in the field with the required value. From the keyboard you should use the Tab and Shift + Tab keys to activate the currently selected value of a radio button and use the cursor control keys to select the desired value from the radio button's possible values.

Text box

The text box control is intended to enter and edit information. It may be used to enter values directly in a field, to select values from lists, and to select links to various objects. A text box may contain various buttons (the range of such buttons is defined during configuration development). For example, they can be used to select or open a value, clear a field, etc. To complete editing, press Enter, Tab, Shift+Tab or click another control with your mouse.

A text box may also be used to work with multi-line text. In this case pressing Enter adds a new line.
If advanced edit mode is enabled for a text box (defined during configuration development), pressing TAB will not allow you navigate to the next form control (instead the tab character will be inserted).

See also: Entering Information in a Form

Selection field

The selection field form control is designed to select one of several possible options. You can choose an option from a list that can be opened alongside the field by clicking a button. The selection can be made with the mouse or the cursor control keys. Cursor control keys can be used to make the selection even without opening the list.

Picture field

The picture field control is intended to place graphics in a form.

A picture field can contain a hyperlink (see the description of label control). When you mouse-over a hyperlinked picture, the cursor will change to a hand .

You can use animated pictures.

See also: Using Keyboard Shortcuts for a Picture Field


A separator is a special control used to allocate form space between other controls. The control is usually a narrow strip oriented horizontally or vertically. A separator is normally located between the form areas, e.g. between a group tree and a table box. To avoid visual clutter, the separator is invisible (it has no borders, and its background is transparent). If a user points at it with a mouse, the pointer will change to  or  depending on the separator's orientation, or to  or , and will become visible (its background changes); in this case, the separator can be dragged with a mouse.
By dragging the separator, you can reallocate form space between form controls snapped to the separator. Items are snapped during configuration design.

Managed form table

A form can contain managed form table controls.

A form may contain one or more tables. A table consists of several columns and is designed to view a large number of rows.


The checkbox control is designed to toggle a value on or off.

Checkboxes with two or three states may be used. The maximum number of checkbox states depends on the value type linked to the checkbox: a checkbox with a Boolean value type can have only two states (set or cleared), while a checkbox with a Number value type can have three states (set, cleared, or undefined).

To toggle a value of a checkbox, click it with your mouse or activate it using the Tab or Shift + Tab keys and press the Spacebar.
To check a checkbox of a Boolean type, press the "+" key on the numeric keypad; to uncheck it, press "-" on the numeric keypad.

Spreadsheet document field

The spreadsheet document field form control is intended to display information as a spreadsheet. Normally the results of a report are output into such a field. The field itself contains a spreadsheet document. In this event spreadsheet documents can contain other controls while cells and groups of cells (areas) can support the “detalization”, i.e. it allows you to obtain a detailed report or information on the data located in this area. When you hover your mouse over such an area, it changes its appearance to crosshairs with a magnifying glass . Pressing Enter in such an area will generate a new report (as defined during task configuration development by the developer). If the data is a reference to a database object (for example, a catalog item value, a document, etc.), an object form is opened.

See also:  Spreadsheet Editor

HTML document field

The HTML document field form control is intended to display information as hypertext. As with any hypertext, in addition to formatted text this box may include hyperlinks, pictures, tables, etc. Usually a form includes a command bar connected to the HTML document box. Such a bar contains navigation commands (in compliance with navigation history). The search, save, and print commands are available for the HTML document box as well.

Note that when you use an HTML document field some HTML functionality may not be supported. Limitations may be caused by specific features of HTML operations in 1C:Enterprise forms in thin and thick clients and in different web browsers. In addition, identical behavior in different browsers and 1C:Enterprise clients is not guaranteed.

Formatted document field

The formatted document field form control is intended to display and edit information as hypertext in managed mode. Such a field is intended to edit formatted text and tables and to enter pictures, links, etc. For example, these fields can be used in various tools intended to prepare and view emails.

1C:Enterprise Developer's Community