Admin: 1 revision imported

2021-02-07T06:52:11Z

1 revision imported

Admin at 15:22, 23 August 2020

2020-08-23T15:22:38Z

New page

{{infobox function
|name=OnBeforeSelect
|object=
|caption=События таблиц
|type=1
|status=2
|db=0
|location=Любой глобальный модуль, текущий локальный модуль
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Предопределенные события]]}}
<p>Функция вызывается для свободных или встроенных [[Электронная таблица SFT|электронных таблиц]] (TABLE) в момент выбора элемента справочника или документа в объект или ячейку таблицы. Позволяет изменить свойства диалога выбора. Для встроенных таблиц будет вызван одноименный обработчик события, если задан, иначе данная функция. Функция вызывается для таблиц в режиме ограниченного редактирования (интерактивном режиме) и только для ячеек (или объектов), которое находятся в процессе редактирования в режиме поля редактирования с наличием связанного элемента _AB_CHOOSE (см. [[Template:AttachedButtonsConstants|таблицу]]), при активацией пользователем этого элемента (или нажатии на ''F4'').</p>
Для дополнительной информации см. статьи [[OnBeforeEdit]], [[OnAfterEdit]], [[Электронная таблица SFT]] и [[Студия/Редактор электронных таблиц|Редактор электронных таблиц]], [[Студия/Визуальные события|Визуальные события]].

== Синтаксис ==
<code>
'''OnBeforeSelect'''(''<Вызывающая таблица (TABLE)>'',{{ByRef|''<Метод выбора (INT,OUT)>''}},{{ByRef|''<Наименование журнала (STRING,OUT)>''}},{{ByRef|''<Наименование модуля (STRING,OUT)>''}},{{ByRef|''<Наименование формы (STRING,OUT)>''}},{{ByRef|''<Параметр вызова (OUT)>''}},{{ByRef|''<Опция вызова (OUT)>''}},{{ByRef|''<Фильтры таблицы выбора (LIST,OUT)>''}},{{ByRef|''<Порядок сортировки (STRING,OUT)>''}},{{ByRef|''<Столбцы таблицы выбора (STRING,OUT)>''}},{{ByRef|''<Список подстановки в таблицу вызова (LIST,OUT)>''}}):<Запретить выбор (INT)>
</code>
==== Аргументы ====
* <code>''<Вызывающая таблица (TABLE)>''</code> - Таблица, для которой произведена попытка открытия редактируемого объекта.
* <code>''<Метод выбора (INT,OUT)>''</code> - {{ByRef}} 0 -- выбор будет происходить в виде выпадающей таблицы, встраиваемой к выбранному реквизиту, 1 -- в виде формы (вызываемой в модальном режиме, см. [[LoadModule]])
* <code>''<Наименование журнала (STRING,OUT)>''</code> - {{ByRef}} Выбор может объекта может происходить как в форме списка объекта, так и в журнале, который включает объекты разных видов. Для выбора объекта из журнала, здесь указывается наименование журнала. Параметр используется при выборе методом 1.
* <code>''<Наименование модуля (STRING,OUT)>''</code> - {{ByRef}} Наименование модуля при отображении формы выбора. Параметр инициализируется модулем по умолчанию, ассоциированным с объектом редактирования. При выборе в журнале должен содержать имя модуля журнала. Параметр используется при выборе методом 1.
* <code>''<Наименование формы (STRING,OUT)>''</code> - {{ByRef}} Наименование формы при отображении формы выбора. Параметр инициализируется формой по умолчанию, ассоциированной с объектом редактирования. При выборе в журнале должен содержать имя формы журнала. Параметр используется при выборе методом 1.
* <code>''<Параметр вызова (OUT)>''</code> - {{ByRef}} Произвольное значение, которое будет доступно в форме выбора объекта в виде переменной '''Param'''. Для справочников с родителями, рекомендуется передавать значение родителя в этом параметре. Параметр используется при выборе методом 1.
* <code>''<Опция вызова (OUT)>''</code> - {{ByRef}} Произвольное значение, которое будет доступно в редактируемом объекте в виде переменной '''Option'''. Параметр используется при выборе методом 1.
* <code>''<Фильтры таблицы выбора (LIST,OUT)>''</code> - {{ByRef}} Список, по которому будет происходить фильтрация таблицы, при этом заголовки элементов списка будут использоваться, как идентификаторы реквизитов фильтра (см. [[Стандартные фильтры]], только простой режим). Пример использования фильтров ищите ниже. Параметр используется при выборе методом 0.
* <code>''<Порядок сортировки (STRING,OUT)>''</code> - {{ByRef}} Строка порядка сортировки таблицы, представляет собой перечисление реквизитов, по которым будет сортироваться таблица, разделенных запятой со знаками ''+'' или ''-'' для указания порядка сортировки. Пример использования сортировки ищите ниже. Параметр используется при выборе методом 0.
* <code>''<Столбцы таблицы выбора (STRING,OUT)>''</code> - {{ByRef}} Идентификаторы реквизитов через запятую, которые будут выведены в столбцы таблицы. По умолчанию встраиваемая таблица для выбора содержит только один столбец с представлением элементов, здесь можно задать другие столбцы (наименования столбцов задаются через запятую). Пример использования ищите ниже. Параметр используется при выборе методом 0.
* <code>''<Список подстановки в таблицу вызова (LIST,OUT)>''</code> - {{ByRef}} Список с элементами, при заполнении которого в таблице будут отображаться только данные элементы списка, запрос к базе данных произведен не будет, а аргументы ''Фильтры таблицы выбора'', ''Порядок сортировки'' и ''Столбцы таблицы выбора'' будут проигнорированы. Параметр используется при выборе методом 0.

==== Возвращаемое значение ====
Если функция возвратит ноль (ответ по умолчанию), действие будет разрешено (будет открыта форма выбора, либо показана выпадащая таблица для выбора), иначе действие будет отменено.

== Примеры ==
<pre>
//Переменная для временного хранения значения ячейки редактирования
Var спРедактируемоеЗначение Export;

Function OnBeforeEdit(SourceTable,EditMode,ObjectType,ObjectIndex,Line,Column,AttButtons,EditValue,EditMask)
...
//Сохранить значение ячейки, так как оно будет утеряно после редактирования
спРедактируемоеЗначение :=SourceTable.Area(Column,Line,Column,Line).Value;
...
EndFunction

Function OnBeforeSelect(SourceTable,ByRef Method,ByRef Journal,ByRef Module,ByRef FormName,ByRef Param,ByRef Option,ByRef Filters,ByRef SortOrder,ByRef Columns,ByRef CustomSelectList)
Result:=1;
if typeStr(спРедактируемоеЗначение )<>"LIST" Then
//Если значение не является списком, не разрешать редактирование
Exit;
EndIf;
if isEmpty(спРедактируемоеЗначение.GetByName("Индекс")) Then
//Если в списке отсутствует элемент с именем "Индекс", не разрешать редактирование
Exit;
EndIf;
//Необходимо выбрать партию номенклатуры, выбор будет производиться в виде выпадающей таблицы
Method:=0;
//В фильтрах укажем родителя и скроем удаленные элементы
Filters:=List.Create();
Filters.SetByName("@Parent",спРедактируемоеЗначение.GetByName("Номенклатура"));
Filters.SetByName("@Status",0);
//Сортировка будет производиться по дате партии
SortOrder:="ДатаПартии+";
//В таблице будут присутствовать дополнительные столбики (код и дата партии)
Columns:="Code,ДатаПартии,Name"
//Разрешить открытие таблицы выбора
Result:=0;
Exit;
EndFunction
</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

OnBeforeSelect - Revision history

Admin: 1 revision imported

Admin at 15:22, 23 August 2020