Возникает перед добавлением строки списка видов характеристик. Данное событие для табличного поля вида характеристик возникает "вместо" одноименного события объекта ТабличноеПоле.
Синтаксис
ПередНачаломДобавления(<Отказ>, <Копирование>, <Родитель>, <ЭтоГруппа>)Полное описание, параметры и ограничения
Расширение табличного поля списка видов характеристик.ПередНачаломДобавления (Characteristic types list table box extension.BeforeAddLine)
Расширение табличного поля списка видов характеристик (Characteristic types list table box extension)
ПередНачаломДобавления (BeforeAddLine)
Доступен, начиная с версии 8.0.
Синтаксис:
ПередНачаломДобавления(<Отказ>, <Копирование>, <Родитель>, <ЭтоГруппа>)
Параметры:
<Отказ>
Тип: Булево.
Признак отказа от добавления строки. Если в теле процедуры-обработчика установить данному параметру значение Истина, то строка списка видов характеристик добавлена не будет.
Значение по умолчанию: Ложь.
<Копирование>
Тип: Булево.
Определяет режим копирования. Если установлено Истина, то происходит копирование строки.
<Родитель>
Тип: ПланВидовХарактеристикСписок.<Имя плана видов характеристик>.
Ссылка на элемент, который будет использован при добавлении в качестве родителя.
<ЭтоГруппа>
Тип: Булево.
Определяет, что добавляется - группа или вид характеристики. Истина - добавляется группа.
Описание:
Возникает перед добавлением строки списка видов характеристик. Данное событие для табличного поля вида характеристик возникает "вместо" одноименного события объекта ТабличноеПоле.
Доступность:
Толстый клиент.
Примечание:
Расширяется набор параметров по сравнению с одноименным событием объекта ТабличноеПоле.
См. также:
ТабличноеПоле, событие ПередНачаломДобавления
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
ПередНачаломДобавления: ПланыВидовХарактеристик → УчебныеСвойстваКниг, свой обычный список
Обработчик назначается настоящему обычному списку конкретных собственных метаданных. Платформа вызывает его после указанной штатной команды пользователя, а не после искусственного вызова процедуры.
Где и как запускать
Модуль собственной обычной формы списка, толстый клиент; событие табличного поля СписокУрока.
Подготовка
В своей учебной конфигурации подготовьте ПланыВидовХарактеристик → УчебныеСвойстваКниг. Иерархия групп и элементов, код Строка 10, наименование 100, допустимый тип значений Строка. Создайте свои группы Книги и Архив и вид характеристики Переплет типа Строка внутри Книги.
Мастером создайте именно обычную форму списка этого объекта. Основной реквизит и табличное поле должны остаться реальным списком метаданных, не ТаблицаЗначений. Поле назовите СписокУрока. Для журнала создаётся форма списка журнала, не форма документа.
Добавьте реквизиты формы РазрешитьИзменение (Булево, исходно Ложь), ЗапретитьСворачивание (Булево, исходно Истина), Статус (Строка 200) и выведите их. Значения по умолчанию задайте в редакторе или при открытии своей формы.
Основной блок назначьте событию СписокУрока → ПередНачаломДобавления через редактор. Обычная форма, толстый клиент в обычном режиме. Дополнительный первый параметр Элемент создаётся редактором поля; серверные директивы здесь не нужны.
Каждый урок самостоятельный и использует только свои строки. Для положительного действия флажок снимается / устанавливается явно; ничего не проверяйте на рабочем справочнике, документе, плане обмена или задаче.
Нажмите штатную команду Копировать своей строки: она отклоняется независимо от флажка. Затем попробуйте Добавить с выключенным и включенным РазрешитьИзменение. Новую строку / карточку после положительной проверки закройте без сохранения.
Процедура СписокУрокаПередНачаломДобавления(Элемент, Отказ, Копирование, Родитель, ЭтоГруппа)
Если Копирование Или Не РазрешитьИзменение Тогда
Отказ = Истина;
Статус = "Копирование запрещено; новое добавление требует своего подтверждения";
Сообщить(Статус);
КонецЕсли;
КонецПроцедурыРазбор по шагам
Подготовьте собственные метаданные, сохраненные строки и обычную форму списка.
Назначьте обработчик точному событию расширения своего списка.
Выполните указанную команду и сравните отказ / разрешение на своей строке.
Как проверить результат
Копирование собственной строки отклонено, обычное добавление разрешается только после подтверждения.
Сигнатура расширения списка содержит Копирование, а у иерархических видов также Родитель и ЭтоГруппа. Она не подменяется базовым событием ТабличноеПоле с меньшим набором параметров.
Ожидаемый результат
Показан типичный интерфейсный контроль конкретной команды своего списка.
На что обратить внимание
Это не проверка прав и не серверный запрет записи. Защита данных должна дополнительно выполняться правами и серверной логикой объекта.
Обычная форма списка не взаимозаменяема с управляемой таблицей динамического списка.
BSL, проведение, обмен, изменение пометок и рабочего состояния агентом не запускались.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.