Tab.FinishEdit - Revision history

Admin: 1 revision imported

2022-11-18T09:39:26Z

1 revision imported

1>Admin at 18:27, 15 October 2022

2022-10-15T18:27:48Z

Admin: 1 revision imported

2021-02-07T06:53:30Z

1 revision imported

Admin: Created page with "{{infobox function |name=FinishEdit |object=Таблица |caption=Работа с редактированием |type=1 |status=2 |db=0 |exception=Невозможно..."

2019-08-22T06:51:45Z

Created page with "{{infobox function |name=FinishEdit |object=Таблица |caption=Работа с редактированием |type=1 |status=2 |db=0 |exception=Невозможно..."

New page

{{infobox function
|name=FinishEdit
|object=[[Таблица]]
|caption=Работа с редактированием
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, неверный индекс
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Таблица]]}}
Функция инициирует окончание редактирования ячейки таблицы в указанном режиме. Работает для визуальных таблиц, для которых активен режим редактирования ячейки. Функция не ожидает результата действия, возвращаясь сразу после вызова. При определенных условиях, в окончании режима редактирования может быть отказано. Функция может быть вызвана для таблиц, где режим редактирования в данный момент не активен, в этом случае, никаких действий выполнено не будет.

== Синтаксис ==
<code>
{{Grey|Tab.}}'''FinishEdit'''({{Optional|<Режим окончания редактирования (INT)>,<Индекс выделенного столбца после окончания редактирования или ноль (INT,STRING)>}})
</code>

==== Аргументы ====
* <code>''<Режим окончания редактирования (INT)>''</code> - {{Optional}} Возможны следующие значения:
** '''0''' -- принять результат редактирования после окончания редактирования.
** '''1''' -- (по умолчанию) отменить редактирование и отказаться от принятия редактирования после окончания редактирования.
* <code>''<Индекс выделенного столбца после окончания редактирования или ноль (INT,STRING)>''</code> - {{Optional}} Задает либо наименование, либо индекс столбца, который будет выделен, как текущий после выполнения действий для окончания редактирования. Если задан 0, будет выполнено изменение текущего столбца, если это необходимо в контексте редактирования таблицы. Особые условия, связанные с изменением текущего столбца при выполнении функции:
# Если происходит принятие результата редактирования (первый аргумент равен ''1''), и индекс нового столбца не задан, система произведен действия по своему усмотрению (будет выбран следующий столбец в цепочке столбцов редактирования и будет инициировано его редактирование).
# Если происходит принятие результата редактирования (первый аргумент равен ''1''), и индекс нового столбца задан, система сначала выполнит окончание редактирования, если окончание удачное, будет активирован указанный столбец и инициирована попытка начать редактирование ячейки этого столбца, если же окончить редактирование не удалось текущий столбце изменен не будет, его редактирование будет продолжено.
# Если происходит отмена принятия результата редактирования (первый аргумент равен ''0''), и отменить редактирование не получилось, либо индекс нового столбца не задан, текущий столбец не будет изменен.
# Если происходит отмена принятия результата редактирования (первый аргумент равен ''0''), индекс нового столбца задан, и отмена редактирования выполнена успешно, система изменит текущий столбец на заданный, инициирование начала редактирования ячейки нового столбца произведено не будет.

== Примеры ==
<pre>
//Ниже показан пример обработчика события OnAfterEditCell для визуальной таблицы
MainTab:=Form.MainTab.Value;
MainTab.CurLine:=MainTab.SelectedLine;

//Если происходит окончание редактирования ячейки в столбце "КодКлиента", найдем
// клиента по коду и пропустим столбец "Клиент" (так как он уже заполнен) и перейдем к редактированию столбца "Сумма"
If MainTab.SelectedColumnName=uppercase("КодКлиента") Then
Код:=Value;
аЭл:=глНайтиПоКоду("кнтКонтрагенты",Код);
If аЭл=0 Then
Box("Контрагента с таким кодом не существует!",Q_STOP);
Exit;
EndIf;
If аЭл.IsFolder() Then
Box("Введенному коду соответствует папка контрагентов!",Q_STOP);
Exit;
EndIf;
//Обновим сохраняемое значение (ведущие нули при вводе были пропущены)
Value:=аЭл.Code;
MainTab.КодКлиента:=Value;
//Заполним следующий столбец "Клиент"
MainTab.Клиент:=аЭл;
//Вызовем успешное завершение редактирования и автоматическую инициацию редактирования столбца "Сумма"
MainTab.FinishEdit(1,"Сумма");
EndIf;
</pre>

← Older revision	Revision as of 09:39, 18 November 2022
(No difference)

@@ Line 22: / Line 22: @@
 ==== Аргументы ====
 * <code>''<Режим окончания редактирования (INT)>''</code> - {{Optional}} Возможны следующие значения:
-** '''0''' -- принять результат редактирования после окончания редактирования.
+** '''0''' -- отказаться от введеленных изменений и окончить редактирование.
-** '''1''' -- (по умолчанию) отменить редактирование и отказаться от принятия редактирования после окончания редактирования.
+** '''1''' -- (по умолчанию) принять результат редактирования и окончить редактирование.
 * <code>''<Индекс выделенного столбца после окончания редактирования или ноль (INT,STRING)>''</code> - {{Optional}} Задает либо наименование, либо индекс столбца, который будет выделен, как текущий после выполнения действий для окончания редактирования. Если задан 0, будет выполнено изменение текущего столбца, если это необходимо в контексте редактирования таблицы. Особые условия, связанные с изменением текущего столбца при выполнении функции:
-# Если происходит принятие результата редактирования (первый аргумент равен ''1''), и индекс нового столбца не задан, система произведен действия по своему усмотрению (будет выбран следующий столбец в цепочке столбцов редактирования и будет инициировано его редактирование).
+# Если происходит принятие результата редактирования (первый аргумент равен ''1'' или ''2''), и индекс нового столбца не задан, система произведен действия по своему усмотрению (будет выбран следующий столбец в цепочке столбцов редактирования и для режима ''2'' будет инициировано его редактирование).
-# Если происходит принятие результата редактирования (первый аргумент равен ''1''), и индекс нового столбца задан, система сначала выполнит окончание редактирования, если окончание удачное, будет активирован указанный столбец и инициирована попытка начать редактирование ячейки этого столбца, если же окончить редактирование не удалось текущий столбце изменен не будет, его редактирование будет продолжено.
+# Если происходит принятие результата редактирования (первый аргумент равен ''1'' или ''2''), и индекс нового столбца задан, система сначала выполнит окончание редактирования, если окончание удачное, будет активирован указанный столбец (и инициирована попытка начать редактирование ячейки этого столбца для режима ''2''), если же окончить редактирование не удалось текущий столбец изменен не будет, и его редактирование будет продолжено.
 # Если происходит отмена принятия результата редактирования (первый аргумент равен ''0''), и отменить редактирование не получилось, либо индекс нового столбца не задан, текущий столбец не будет изменен.
 # Если происходит отмена принятия результата редактирования (первый аргумент равен ''0''), индекс нового столбца задан, и отмена редактирования выполнена успешно, система изменит текущий столбец на заданный, инициирование начала редактирования ячейки нового столбца произведено не будет.
@@ Line 55: / Line 56: @@
    MainTab.Клиент:=аЭл;
    //Вызовем успешное завершение редактирования и автоматическую инициацию редактирования столбца "Сумма"
-   MainTab.FinishEdit(1,"Сумма");
+   MainTab.FinishEdit(2,"Сумма");
 EndIf;
 </pre>

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