ТаблицаФормы.ПередРазворачиванием

События · BeforeExpand

Вызывается перед раскрытием узла таблицы, отображаемого в виде дерева.

Синтаксис

ПередРазворачиванием(<Строка>, <Отказ>)
Полное описание, параметры и ограничения

ТаблицаФормы.ПередРазворачиванием (FormTable.BeforeExpand)

ТаблицаФормы (FormTable)

ПередРазворачиванием (BeforeExpand)

Доступен, начиная с версии 8.2.

Синтаксис:
ПередРазворачиванием(<Строка>, <Отказ>)
Параметры:

<Строка>
Тип: Произвольный.
Строка, которая будет развернута.
Тип значения зависит от типа данных, отображаемых в таблице.

<Отказ>
Тип: Булево.
Признак отказа от записи объекта. Если в теле процедуры-обработчика установить данному параметру значение Истина, то запись объекта выполнена не будет.
Значение по умолчанию: Ложь.
Описание:

Вызывается перед раскрытием узла таблицы, отображаемого в виде дерева.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, мобильное приложение (клиент).

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

Доступен, начиная с версии 8.2.

Описание изменено в версии 8.3.15.

Методическая информация

Практические примеры

ПередРазворачиванием: собственная управляемая таблица

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

Где и как запускать

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

Подготовка

  1. В отдельной учебной конфигурации создайте иерархический справочник УчебныеТоварыКонтроля (группы и элементы, строковый код 10 с автонумерацией, наименование 100). В предприятии создайте свою группу Книги и внутри элемент Учебник.

  2. У справочника создайте управляемую форму списка: основной реквизит Список типа ДинамическийСписок с основной таблицей Справочник.УчебныеТоварыКонтроля; таблица формы Товары с путём Список.

  3. Для ПередРазворачиванием / ПередСворачиванием у таблицы выберите отображение Дерево. Для ПриСменеТекущегоРодителя выберите Иерархический список и переходите внутрь своей группы / обратно.

  4. Добавьте реквизиты формы ЗапретитьСворачивание (Булево, начальное Истина) и Статус (Строка 200), выведите их на форму. Основной обработчик назначьте событию таблицы Товары.

  5. Рабочие справочники не используются. Не добавляйте сюда подготовку плоской таблицы из другого урока.

&НаКлиенте
Процедура ТоварыПередРазворачиванием(Элемент, Строка, Отказ)
    Если ЗапретитьСворачивание Тогда
        Отказ = Истина;
        Сообщить("Снимите учебный запрет для изменения раскрытия узла");
    КонецЕсли;
КонецПроцедуры

Разбор по шагам

  1. Подготавливаем настоящую собственную таблицу / список и назначаем точное событие.

  2. Параметры после Элемент соответствуют установленной справке конкретного типа.

  3. Локальный флажок формы запрещает конкретное действие раскрытия / сворачивания собственного дерева. Ни запроса к базе, ни серверного обращения из события нет.

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

  1. С включённым флажком действие над узлом Книги отменяется.

  2. Выключите флажок: стандартное действие допускается. Это интерфейсное правило, не запрет чтения данных.

Ожидаемый результат

Событие работает с собственными данными и реально заданным источником действия.

На что обратить внимание

  1. Не вызывайте обработчики событий вручную: проверяйте указанное пользовательское действие.

  2. События активизации, наведения, раскрытия и смены родителя не должны вызывать серверные методы формы.

  3. Обычная и управляемая формы имеют разные API; не переносите между ними элементы и процедуры без адаптации.

  4. Таблица значений хранит данные формы, не записывает их в регистр автоматически.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.