1С управляемая форма: как добавить разделитель

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

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

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

Как устроены разделители в управляемом интерфейсе

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

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

Разделитель в командной панели и контекстном меню

Самый частый случай — визуально разделить кнопки в командной панели формы, подменю или контекстном меню таблицы. Для этого в конфигураторе в дереве элементов формы внутрь командной панели добавляется элемент типа «Группа» с видом «Группа кнопок». Кнопки, помещённые в разные такие группы, отделяются друг от друга вертикальной чертой — это и есть разделитель.

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

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

1. 1
   Откройте управляемую форму в конфигураторе
2. 2
   В дереве элементов найдите КоманднаяПанель
3. 3
   Добавьте в неё элемент Группа с видом ГруппаКнопок
4. 4
   Перетащите в новую группу кнопки, которые должны идти после разделителя
5. 5
   Обновите конфигурацию и проверьте вид панели в режиме предприятия

Программное добавление разделителя в меню

Если элементы формы создаются динамически — например, в универсальной обработке или при формировании меню по данным настроек, — разделитель добавляется кодом. Используется метод Элементы.Добавить() с типом Тип("ГруппаФормы") и установкой вида группы.

// Создаём кнопку до разделителя
НоваяКнопка = Элементы.Добавить("КнопкаПечать", Тип("КнопкаФормы"), Элементы.КоманднаяПанель);
НоваяКнопка.ИмяКоманды = "Печать";

// Группа-разделитель
ГруппаРазделитель = Элементы.Добавить("ГруппаРазделитель", Тип("ГруппаФормы"), Элементы.КоманднаяПанель);
ГруппаРазделитель.Вид = ВидГруппыФормы.ГруппаКнопок;

// Кнопка после разделителя — добавляется в группу
ВтораяКнопка = Элементы.Добавить("КнопкаОтправить", Тип("КнопкаФормы"), ГруппаРазделитель);
ВтораяКнопка.ИмяКоманды = "Отправить";

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

ГруппаРазделитель = Элементы.Добавить("ГруппаРазделитель", Тип("ГруппаФормы"), Элементы.КоманднаяПанель);
ГруппаРазделитель.Вид = ВидГруппыФормы.ГруппаКнопок;

Визуальное отделение блоков полей на форме

Когда нужно отделить не кнопки, а области ввода — например, блок «Основные реквизиты» от блока «Дополнительно» — применяются другие приёмы. Самый простой: декорация вида «Надпись» с пустым текстом или с текстом-заголовком, для которой задано свойство оформления. Декорация с заголовком визуально работает как подпись секции и отделяет содержимое.

Второй приём — обычная группа с включённым отображением заголовка или рамки. Группа с заголовком даёт чёткую визуальную границу и одновременно структурирует форму: при сворачивании группы пользователь скрывает целый блок. Это предпочтительный способ, если блоков много и форма перегружена.

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

Разделитель в динамически создаваемых формах: нюансы

При программном построении формы все манипуляции выполняются на сервере — в ПриСозданииНаСервере или в серверных процедурах с последующим обновлением. Добавление элементов на клиенте невозможно: методы Элементы.Добавить() и Элементы.Удалить() доступны только в серверном контексте.

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

Типичные ошибки и как их избежать

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

Вторая ошибка — добавление кнопок не в ту группу. Если после создания группы-разделителя кнопку добавить в командную панель, а не в группу, разделитель визуально «съедет»: кнопка окажется до разделителя. Всегда проверяйте третий параметр метода Элементы.Добавить() — родительский элемент.

Третья ошибка — попытка добавить элементы в обработчике ПриОткрытии на клиенте. Код выполнится с ошибкой или молча не сработает, потому что изменение структуры формы возможно только на сервере до отображения формы пользователю.

Проверка результата

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

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

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