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

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

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

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

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

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

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

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

Настройка группы в конфигураторе перед программным управлением

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

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

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

1. 1
   Откройте форму в конфигураторе и выделите группу
2. 2
   Установите ОтображениеСвертки = Кнопка
3. 3
   Задайте понятный заголовок группы
4. 4
   При необходимости установите Свертка = Истина для начального состояния
5. 5
   Сохраните форму и проверьте поведение в режиме предприятия

Программное сворачивание и разворачивание группы

Обращение к элементу формы выполняется через коллекцию Элементы модуля формы. Базовый код сворачивания выглядит так:

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

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

Имя элемента («ГруппаДополнительно» в примере) должно точно совпадать с именем группы в дереве элементов формы, с учетом регистра. Ошибка в имени — самая частая причина «неработающего» кода: платформа выдаст ошибку «Поле объекта не обнаружено».

Часто требуется переключение состояния одной командой. Для этого удобно инвертировать текущее значение:

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

&НаКлиенте
Процедура ПриИзмененииРежима(Элемент)
	Если Объект.РасширенныйРежим Тогда
		Элементы.ГруппаДополнительно.Свертка = Ложь;
	Иначе
		Элементы.ГруппаДополнительно.Свертка = Истина;
	КонецЕсли;
КонецПроцедуры

Установка состояния при открытии формы

Если начальное состояние зависит от данных объекта или настроек пользователя, свойство Свертка устанавливают в обработчике ПриСозданииНаСервере или ПриОткрытии. Вариант на сервере предпочтительнее, когда условие зависит от реквизитов объекта:

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

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

Если состояние нужно запоминать между сеансами, сохраняйте его, например, через ХранилищеОбщихНастроек при закрытии формы и восстанавливайте при создании. Само по себе свойство свертки между сеансами не сохраняется.

Динамическое управление сверткой по условиям

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

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

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

Для нескольких условий логику удобно вынести в отдельную процедуру УстановитьВидимостьИСвертку() и вызывать ее из всех обработчиков, влияющих на состояние. Это исключает рассинхронизацию, когда разные обработчики по-разному управляют одной группой.

Проверка результата и типичные ошибки

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

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

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

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