Как программно переместить существующий элемент формы относительно созданных динамически

← На главную

В процессе разработки на платформе 1С:Предприятие 8.3 часто возникает задача динамического изменения интерфейса — для этого пригодятся консоль кода и редактор объектов 1С. Одной из таких задач является программное перемещение существующих элементов (созданных в конфигураторе) относительно тех, которые были добавлены программно в коде модуля формы. Рассмотрим подробнее, как работает механизм перемещения, разберем типичные ошибки и выясним, почему иногда метод Переместить() не дает видимого результата.

Разбор метода Переместить() и его параметров

Для изменения положения элемента в коллекции Элементы используется встроенный метод Переместить(). Прежде чем приступать к кодингу, проанализируем синтаксис этого метода. Он принимает три параметра:

Элемент — собственно тот элемент управления, который мы хотим передвинуть.
Родитель — новый (или текущий) родительский элемент (например, ГруппаФормы или сама ЭтаФорма), в который помещается элемент.
Позади — элемент, ПОСЛЕ которого должен встать наш перемещаемый объект. Если передать Неопределено, элемент станет первым в списке внутри своего родителя.

Рассмотрим стандартный пример кода:


// Перемещаем существующее поле "ЕдиницаИзмерения" в новую группу
// и ставим его после программно созданного элемента "НовЭлемент"
Элементы.Переместить(Элементы.ЕдиницаИзмерения, ЭлементНовойГруппы, НовЭлемент);

Почему перемещение может не работать?

Проанализируем ситуацию, когда код написан, ошибки не возникает, но элемент остается на прежнем месте (поможет пошаговая отладка кода в режиме Предприятие). Одной из главных причин является несоответствие родителя и опорного элемента. Если вы пытаетесь переместить поле в Группу А, но в качестве третьего параметра (Позади) указываете элемент, который находится в Группе Б, система проигнорирует команду или отработает некорректно. Опорный элемент обязан иметь того же родителя, который указан во втором параметре метода.

Также важно учитывать контекст выполнения. Метод Элементы.Переместить() доступен только на сервере. На клиенте манипулировать составом и порядком коллекции элементов невозможно.

Особенности перемещения колонок в таблицах

Работа с табличными частями и их колонками — это отдельный пласт задач. Здесь родителем может выступать либо сама ТаблицаФормы, либо специальные объекты — ГруппаКолонок. Выясним важный нюанс: если элемент находится внутри группы колонок, то перемещать нужно именно внутри этой иерархии.

Посмотрим на пример из практики, когда нужно переместить группу колонок:


// Перемещаем группу колонок в табличной части
Элементы.Переместить(
    Элементы.ЛистВрачебныхНазначенийГруппаЕдИзм, 
    Элементы.ЛистВрачебныхНазначенийГруппаЕдИзм.Родитель, 
    НовЭлемент
);

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

Пошаговый алгоритм программного изменения порядка

Рассмотрим правильную последовательность действий для гарантированного результата:

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

Влияние пользовательских настроек

Часто программисты забывают о том, что в управляемых формах 1С настройки пользователя имеют приоритет. Если пользователь когда-либо нажимал "Изменить форму" и вручную перетаскивал колонки, программный метод Переместить() может не возыметь визуального эффекта. Платформа будет применять сохраненную пользовательскую позицию поверх программной логики.

Чтобы "сбросить" это поведение в рамках разработки, можно временно программно установить настройки формы в начальное состояние или использовать метод УстановитьПараметрыФункциональныхОпцийФормы(), хотя это радикальный метод. Чаще всего достаточно убедиться, что программная логика выполняется в процедуре ПриСозданииНаСервере до того, как форма была полностью отрисована пользователю.

Работа с позиционированием "в начало"

Если ваша задача — сделать существующий элемент самым первым (например, первой колонкой таблицы), используйте Неопределено в качестве третьего параметра. Это часто вызывает путаницу, так как разработчики пытаются найти "нулевой" элемент, которого не существует в контексте метода Переместить().


// Перемещаем поле в самое начало родительской группы
Элементы.Переместить(Элементы.ВажноеПоле, Элементы.НужнаяГруппа, Неопределено);

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