Admin: 1 revision imported

2021-02-07T06:52:10Z

1 revision imported

Admin at 08:09, 28 January 2021

2021-01-28T08:09:44Z

New page

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

== Синтаксис ==
<code>
'''OnBeforeEdit'''(''<Вызывающая таблица (TABLE)>'',{{ByRef|<Режим редактирования (INT,OUT)>}},''<Тип объекта (INT)>'',''<Индекс объекта (INT)>'',''<Строка (INT)>'',''<Столбец (INT)>'',{{ByRef|<Связанные элементы (STRING,OUT)>}},{{ByRef|<Значение для редактирования (OUT)>}},{{ByRef|<Маска для редактирования (STRING,OUT)>}})
</code>
==== Аргументы ====
* <code>''<Вызывающая таблица (TABLE)>''</code> - Таблица, для которой произведена попытка редактирования ячейки.
* <code>''<Режим редактирования (INT,OUT)>''</code> - {{ByRef}} 0 -- использовать встроенный (текстовый) редактор SFT, 1 -- использовать редактор с возможностями поля редактирования, 2 -- запретить редактирование.
* <code>''<Тип объекта (INT)>''</code> - '''-1''', если редактируется ячейка, иначе цифровой тип объекта, для которого инициирована попытка редактирования. Текущие типы объектов:
** '''-1''' -- ячейка таблицы
** '''0''' -- линия (редактирование для данного объекта не осуществляется)
** '''1''' -- прямоугольник
** '''2''' -- картинка
** '''3''' -- OLE-объект
** '''4''' -- диаграмма
* <code>''<Индекс объекта (INT)>''</code> - Индекс объекта таблицы, для которого инициирован режим редактирования, если редактируется ячейка, данный параметр принимает значение '''-1'''.
* <code>''<Строка (INT)>''</code> - Строка таблицы ячейки редактирования, если редактируется объект, данный параметр принимает значение '''-1'''.
* <code>''<Столбец (INT)>''</code> - Столбец таблицы ячейки редактирования, если редактируется объект, данный параметр принимает значение '''-1'''.
* <code>''<Связанные элементы (STRING,OUT)>''</code> - {{ByRef}} Связанные элементы, ассоциированные с полем редактирования, если редактирование будет производиться в режиме 1. Параметр представляет собой строку с перечислением через запятую индексов связанных элементов. К примеру <code>""+_AB_CHOOSE+","+_AB_CLEAR+","+_AB_HELP</code> (см. [[Template:AttachedButtonsConstants|список значений констант связанных элементов]]).
* <code>''<Значение для редактирования (OUT)>''</code> - {{ByRef}} Значение любого типа, которое попадет в поле редактирование для режима 1. Значение может быть никак не связано с текущим текстом ячейки или объекта таблицы.
* <code>''<Маска для редактирования (STRING,OUT)>''</code> - {{ByRef}} Маска поля редактирования, если редактирование происходит в режиме 1. Маска может быть стандартной маской (см. [[Tab.Column.Mask]]), однако для чисел подобная стандартная маска неудобна, поэтому можно задать специальную числовую маску в виде <code>"!<Цифр в числе>.<Цифр в мантиссе>"</code> (к примеру "!15.3").

== Примеры ==
<pre>
Function OnBeforeEdit(SourceTable,EditMode,ObjectType,ObjectIndex,Line,Column,AttButtons,EditValue,EditMask)
//Запретить редактировать по умолчанию
EditMode:=2;
If ObjectType<>-1 Then
//Редактирование не производится для объектов
Exit;
EndIf;
//Получить значение ячейки таблицы (в отличие от ее видимого текста, значение может содержать произвольный объект и не видно пользователю)
aList:=SourceTable.Area(Column,Line,Column,Line).Value;
if typeStr(aList)<>"LIST" Then
//Если значение не является списком, не разрешать редактирование
Exit;
EndIf;
if isEmpty(aList.GetByName("Индекс")) Then
//Если в списке отсутствует элемент с именем "Индекс", не разрешать редактирование
Exit;
EndIf;
//Получить текст ячейки редактирования и превратить его в число
EditValue:=Number(Replace(Replace(SourceTable.Area(Column,Line,Column,Line).Text,"'","")," ",""));
//Производится редактирование в режиме расширенного редактора
EditMode:=1;
//При рекдатировани использовать редактор числа с двумя знаками после десятичной точки
EditMask:="!10.2";
//Добавить связанный элемент (кнопку) с иконкой калькулятора, которая автоматически будет вызывать калькулятор для помощи в редактировании числового поля
AttButtons:=""+_AB_CALC;
EndFunction
</pre>

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

OnBeforeEdit - Revision history

Admin: 1 revision imported

Admin at 08:09, 28 January 2021