OnBeforeEditObject

OnBeforeEditObject (События таблиц)
Статус разработки: Реализована Тип: Функция Обращение к БД: Нет Расположение: Любой глобальный модуль, текущий локальный модуль Визуальность: Да

• Начальная страница
• Общее описание
• Предопределенные события

Функция вызывается для свободных или встроенных электронных таблиц (TABLE) до открытия формы редактирования (или просмотра) объекта. Для встроенных таблиц будет вызван одноименный обработчик события, если задан, иначе данная функция. Функция вызывается для таблиц в режиме ограниченного редактирования (интерактивном режиме) и только для ячеек (или объектов), которое находятся в процессе редактирования в режиме поля редактирования с наличием связанного элемента _AB_INFO (см. таблицу), при активацией пользователем этого элемента.

Функция может подменить открываемый объект на необходимый перед началом редактирования.

Для дополнительной информации см. статьи OnBeforeEdit, OnAfterEdit, Электронная таблица SFT и Редактор электронных таблиц

Синтаксис

OnBeforeEditObject(<Вызывающая таблица (TABLE)>,<Объект редактирования (OUT)>,<Метод редактирования (INT,OUT)>,<Наименование модуля (STRING,OUT)>,<Наименование формы (STRING,OUT)>,<Параметр вызова (OUT)>,<Опция вызова (OUT)>):<Разрешить редактирование (INT)>

Аргументы

• <Вызывающая таблица (TABLE)> - Таблица, для которой произведена попытка открытия редактируемого объекта.
• <Объект редактирования (OUT)> - (возможен аргумент-переменная (ByRef)) Объект, для которого открывается форма редактирования
• <Метод редактирования (INT,OUT)> - (возможен аргумент-переменная (ByRef)) 0 -- режим редактирования, 1 -- только просмотр
• <Наименование модуля (STRING,OUT)> - (возможен аргумент-переменная (ByRef)) Наименование модуля при отображении объекта для редактирования. Параметр инициализируется модулем по умолчанию, ассоциированным с объектом редактирования.
• <Наименование формы (STRING,OUT)> - (возможен аргумент-переменная (ByRef)) Наименование формы при отображении объекта для редактирования. Параметр инициализируется формой по умолчанию, ассоциированной с объектом редактирования.
• <Параметр вызова (OUT)> - (возможен аргумент-переменная (ByRef)) Произвольное значение, которое будет доступно в редактируемом объекте в виде переменной Param. Для справочников с родителями, рекомендуется передавать значение родителя в этом параметре.
• <Опция вызова (OUT)> - (возможен аргумент-переменная (ByRef)) Произвольное значение, которое будет доступно в редактируемом объекте в виде переменной Option

Возвращаемое значение

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

Примеры

Function OnBeforeEditObject(SourceTable,ByRef Object,ByRef Method,ByRef Module,ByRef FormName,ByRef Param,ByRef Option)
  If _And(IsDBObject(Object),DBObjectName(Object)="Номенклатура") Then
    //Разрешить открытие объекта этого вида только для просмотра
    Method:=1;
  EndIf;
  //Передать в форму объекта дополнительный параметр
  Param:=List.Create();
  Param.SetByName("ИзУстановкиПланов",1);
  Exit 1;
EndFunction