К статье
Практический материал

Другое · 7 мин

Перебор всех элементов формы в 1С: практическое руководство

Как в 1С перебрать элементы формы: обход коллекции Элементы, смена доступности и видимости, группы и табличные части, ограничения и проверка результата.

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

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

Перебор элементов не должен становиться способом обхода бизнес-логики: массовое скрытие обязательных реквизитов или блокировка важных команд может привести к потере данных или невозможности провести документ. Поэтому изменения в цикле лучше проверять на копии базы и только после согласования с пользователями.

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

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

Порядок действий
  1. 1
    Определите тип формы и место кода: клиентский модуль управляемой формы
  2. 2
    Напишите цикл Для Каждого Элемент Из Элементы Цикл ... КонецЦикла
  3. 3
    Укажите условие пропуска служебных элементов и кнопок
  4. 4
    Измените нужные свойства и проверьте результат на тестовых данных

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

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

Для Каждого Элемент Из Элементы Цикл
Если Элемент.Имя = "КнопкаЗакрытия" Тогда
Продолжить;
КонецЕсли;

Элемент.Доступность = Ложь;
Элемент.Видимость = Истина;
КонецЦикла;

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

Пример проверки типа элемента

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

Что можно менять у элементов в цикле

Чаще всего программисты меняют Доступность и Видимость. Доступность блокирует редактирование, но поле остаётся виден, а Видимость полностью убирает элемент с формы. Также можно менять Заголовок, ЦветФона, ЦветТекста и Шрифт, хотя массовая смена оформления может ухудшить восприятие интерфейса.

Для полей ввода, связанных с реквизитами, изменение значения через Элемент.Значение работает не во всех ситуациях. Надёжнее менять сам реквизит объекта или документа, а не элемент формы, иначе изменения могут не сохраниться или не отобразиться после переоткрытия формы.

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

Особенности табличных частей и динамических элементов

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

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

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

Ограничения и риски при массовых изменениях

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

Типичные ошибки
01
Попытка изменить коллекцию элементов во время перебора приводит к пропуску или ошибке
02
Массовое скрытие обязательных реквизитов делает документ невозможным для сохранения

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

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

Контрольные точки

Как проверить результат

Поля стали недоступны или скрыты
Норма

Целевые поля не редактируются или не видны

Тревожный признак

Поля остаются активными или исчезли служебные кнопки

Документ сохраняется
Норма

Проведение и запись проходят без ошибок

Тревожный признак

Ошибка обязательных реквизитов при сохранении

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

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

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

Итог

Что важно запомнить

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

Можно ли перебирать элементы формы на сервере?

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

Что делать, если нужный элемент отсутствует в коллекции?

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

Безопасно ли массово скрывать поля формы?

Только после проверки обязательности реквизитов и правил заполнения. Скрытие важного поля может привести к ошибке сохранения или потере данных.

Нужно ли переоткрывать форму после изменений?

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