Как программно свернуть группу на форме 1С

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

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

Какие виды групп поддерживают сворачивание

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

Перед написанием кода убедитесь, что группа имеет вид «Обычная группа». Если в конфигураторе выбран другой вид (например, «Группа колонок» или «Командная панель»), попытка обратиться к свойству сворачивания приведёт к ошибке исполнения, потому что у элемента такого свойства просто нет.

Сворачивание группы в управляемой форме

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

Элементы.ГруппаДополнительно.Поведение = ПоведениеОбычнойГруппы.Свертываемая;
Элементы.ГруппаДополнительно.Свернута = Истина;

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

Также доступен метод Скрыть() у элемента формы, который сворачивает группу программно. На практике чаще используют именно свойство Свернута, так как оно нагляднее и позволяет читать состояние. Учтите: если свойство Поведение установлено в «Обычное», присвоение Свернута = Истина не даст видимого эффекта — сначала включите сворачиваемость.

&НаКлиенте
Процедура ПереключитьГруппу(Команда)
	Элементы.ГруппаДополнительно.Свернута = НЕ Элементы.ГруппаДополнительно.Свернута;
КонецПроцедуры

Настройка сворачивания в конфигураторе без кода

Если группа должна быть свёрнута всегда при открытии, код может вообще не понадобиться. В редакторе формы выделите группу и в палитре свойств установите: «Поведение» — «Свертываемая», «Свернута» — «Истина». Дополнительно полезно заполнить свойство «Заголовок свернутого отображения» — текст, который увидит пользователь рядом со стрелкой разворачивания.

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

Сворачивание группы в обычной форме

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

ЭлементыФормы.ГруппаНастроек.Свернутость = Истина; // свернуть
ЭлементыФормы.ГруппаНастроек.Свернутость = Ложь;   // развернуть

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

Типовые сценарии программного управления

Свернуть группу при открытии формы по условию

Частая задача: показать блок «Дополнительно» свёрнутым, если данные не заполнены, и развернуть, если есть что показать. Логично разместить проверку в обработчике ПриСозданииНаСервере или ПриОткрытии:

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Элементы.ГруппаДополнительно.Свернута = Не ЕстьДопДанные();
КонецПроцедуры

Развернуть группу при ошибке заполнения

Если проверка заполнения выявила ошибку в поле внутри свёрнутой группы, пользователь не увидит проблемное поле, пока не развернёт блок вручную. Хорошая практика — программно разворачивать группу при сообщении об ошибке и, при необходимости, активизировать элемент через ТекущийЭлемент.

Переключение по команде формы

Кнопка «Показать дополнительные сведения» может инвертировать состояние группы. Пример такого обработчика приведён в виджете кода выше: одна строка читает текущее значение Свернута и присваивает противоположное.

Типичные ошибки и ограничения

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

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

Отдельно учитывайте момент вызова. В управляемой форме обращение к Элементы возможно только в контексте формы — из модуля объекта или общего модуля без передачи формы свернуть группу нельзя. Для внешних воздействий используйте оповещения или параметры формы.

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

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

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

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