Элемент управления в 1С: что это и как с ним работать

Элемент управления в 1С — это визуальный объект формы, через который пользователь вводит, просматривает или изменяет данные, а разработчик управляет поведением интерфейса. Поле ввода, кнопка, таблица, флажок, надпись, переключатель — всё это элементы управления. Именно из них складывается любая форма документа, справочника или отчёта в конфигурации.

Понимание того, что такое элемент управления, необходимо в двух ситуациях: когда вы настраиваете форму под задачи пользователей (добавляете поле, меняете порядок, прячете лишнее) и когда дорабатываете конфигурацию в конфигураторе. Без этого понятия невозможно корректно связать данные объекта с тем, что человек видит на экране.

Термин используется и в управляемых, и в обычных формах, но механика различается: в управляемых формах платформа сама строит расположение элементов, а в обычных разработчик размещал их вручную по координатам. Ниже разберём виды элементов, способы их добавления, настройку свойств и типичные ошибки.

Что такое элемент управления и как он связан с данными

Каждый элемент формы выполняет одну из трёх задач: отображает данные, принимает ввод от пользователя или запускает действие (команду). Например, поле «Контрагент» в документе показывает и позволяет выбрать значение, а кнопка «Провести и закрыть» выполняет команду без хранения данных.

Ключевой принцип: элемент управления, который работает с данными, должен быть связан с реквизитом формы или объекта. Эта связь задаётся в свойстве элемента (в управляемых формах — «ПутьКДанным»). Если связи нет, поле существует визуально, но введённое в него значение никуда не сохранится — это одна из самых частых причин «пропадающих» данных у начинающих разработчиков.

Основные виды элементов управления

Платформа предоставляет типовой набор элементов, достаточный для построения большинства интерфейсов. Выбор конкретного вида зависит от типа данных и сценария работы пользователя.

• Поле ввода — ввод и редактирование значений: строк, чисел, дат, ссылок на справочники и документы.
• Поле надписи — вывод текстовой информации без возможности редактирования.
• Флажок — работа с булевыми значениями (да/нет).
• Переключатель — выбор одного варианта из фиксированного списка.
• Поле списка / выпадающий список — выбор из перечисления или произвольного списка значений.
• Таблица формы — отображение и редактирование табличных частей и динамических списков.
• Кнопка — выполнение команды формы или стандартной команды.
• Группа — контейнер для объединения элементов (страницы, колонки, обычная группа).
• Декорация — надписи, картинки, рамки для оформления формы.

Стоит понимать, что один и тот же реквизит можно отобразить разными элементами: булево значение — флажком или переключателем, ссылку на справочник — полем ввода с выбором или выпадающим списком. Платформа часто подбирает вид автоматически по типу данных, но разработчик может изменить его в свойстве «Вид».

Как добавить элемент управления на форму в конфигураторе

Работа ведётся в конфигураторе: откройте нужный объект (например, документ), перейдите на вкладку «Формы» и откройте основную форму. Если формы нет, платформа предложит создать её конструктором — для типовых задач этого достаточно.

1. 1
   Откройте форму объекта в конфигураторе
2. 2
   В дереве элементов выделите группу, внутри которой должен располагаться новый элемент
3. 3
   Нажмите «Добавить» и выберите тип элемента (поле, кнопка, группа и т.д.)
4. 4
   Укажите имя элемента и заголовок, который увидит пользователь
5. 5
   Свяжите элемент с данными: выберите реквизит в свойстве «ПутьКДанным»
6. 6
   Сохраните форму, обновите конфигурацию базы данных и проверьте результат в режиме 1С:Предприятие

В управляемых формах нельзя задать элементу точные координаты — платформа сама компонует форму с учётом групп и порядка элементов. Управлять расположением можно через иерархию в дереве элементов: перемещайте элемент в нужную группу и меняйте его позицию стрелками «вверх/вниз». Это принципиальное отличие от обычных форм, где поля размещались мышью на макете.

Настройка свойств элемента: что менять в первую очередь

Палитра свойств открывается по правому клику на элементе. Набор свойств зависит от вида элемента, но есть универсальные, которые определяют поведение в большинстве сценариев.

• Имя — программный идентификатор, по которому элемент доступен из кода модуля формы.
• Заголовок — текст, видимый пользователю.
• ПутьКДанным — связь с реквизитом формы или объекта.
• Доступность и ТолькоПросмотр — блокировка элемента или запрет редактирования.
• Видимость — показ или скрытие элемента.
• АвтоотметкаНезаполненного / Проверка заполнения — контроль обязательности ввода.
• КнопкаВыпадающегоСписка, КнопкаВыбора, КнопкаОчистки — управление кнопками у полей ввода.

Динамическое управление свойствами выполняется из кода модуля формы. Например, скрыть поле по условию можно так:

&НаКлиенте
Процедура ПриОткрытии(Отказ)
    Элементы.ПолеКомментарий.Видимость = Ложь;
КонецПроцедуры

Обращение к элементу всегда идёт через коллекцию Элементы формы по имени элемента, а не по имени реквизита — эти имена могут совпадать, но это разные сущности.

Элементы управления в обычных и управляемых формах

Если вы работаете со старой конфигурацией на обычных формах (режим обычного приложения), механика отличается: элементы размещаются на диалоге визуально, их положение фиксировано, а связь с данными задаётся в свойстве «Данные». В управляемых формах позиционирование декларативное — вы описываете структуру, а платформа строит интерфейс под разные клиенты (тонкий, веб, мобильный).

При доработке типовой конфигурации предпочтительно не менять типовую форму напрямую, а использовать расширения конфигурации или программное изменение формы в событии «ПриСозданииНаСервере». Это снижает трудозатраты при обновлении конфигурации на новые релизы.

Типичные ошибки при работе с элементами формы

Отдельная группа проблем связана с таблицами формы: если таблица не отображает данные, проверьте, что она связана с табличной частью или динамическим списком, а у колонок корректно заполнен путь к данным. Для динамических списков дополнительно проверяйте текст запроса и настройку основной таблицы.

Когда стоит привлекать специалиста

Самостоятельная настройка безопасна, если вы добавляете элементы в тестовой копии базы, работаете через расширение и не трогаете код проведения документов. Рискованные сценарии — изменение форм, участвующих в обменах данными, доработка сложных динамических списков с произвольными запросами и любые изменения в рабочей базе без резервной копии.

Частые вопросы