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

Другое · 6 мин

Программное удаление элемента формы в 1С:Предприятие

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

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

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

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

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

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

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

Порядок действий
  1. 1
    Убедитесь, что форма управляемая и элемент добавлен программно
  2. 2
    Проверьте существование элемента по имени
  3. 3
    Выполните Elemente.Удалить("ИмяЭлемента")
  4. 4
    Проверьте, что форма открывается и элемент исчез

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

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

Перед удалением целесообразно убедиться, что элемент присутствует в коллекции. Для этого используется Elemente.Содержит("ИмяЭлемента") или Elemente.Найти("ИмяЭлемента") <> Неопределено. Только после положительной проверки вызывается Elemente.Удалить. Такой подход предотвращает остановку работы формы из-за отсутствия управления.

Безопасное удаление и проверка результата

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

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

Ограничения и риски

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

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

Типичные ошибки
01
Удаление несуществующего элемента без проверки Elemente.Содержит
02
Путаница имени элемента формы с именем реквизита
03
Попытка удалить статический элемент конфигуратора во время выполнения

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

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

Вместо удаления часто достаточно скрыть управление: задать Видимость = Ложь или Доступность = Ложь. Это оставляет элемент в коллекции, но убирает его с экрана или делает недоступным для редактирования. Если элемент нужно вернуть в той же сессии, удалённый программно элемент придётся добавлять заново через Elemente.Добавить, поэтому скрытие чаще бывает более гибким решением.

Итог

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

Удаляйте только программно добавленные элементы управляемой формы, проверяйте существование перед удалением и тестируйте на копии базы.

Часто задаваемые вопросы

Можно ли удалить элемент, созданный в конфигураторе?

Как правило, статические элементы, описанные в конфигураторе, не удаляются методом Elemente.Удалить во время выполнения, потому что они входят в структуру формы. Удаление доступно преимущественно для элементов, добавленных программно.

Что будет, если удалить отсутствующий элемент?

Платформа выдаст ошибку во время выполнения, поэтому перед Elemente.Удалить следует проверить Elemente.Содержит или использовать обработку исключений Попытка … Исключение.

Отличается ли удаление в обычных и управляемых формах?

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

Нужно ли удалять элемент, если он лишь должен быть скрыт?

Не обязательно. Часто достаточно установить Видимость = Ложь или Доступность = Ложь. Полное удаление уместно, когда управление вообще не должно существовать в текущем контексте и возвращаться в той же сессии не требуется.

Удаляет ли Elemente.Удалить данные формы?

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