OnMark - Revision history

Admin: 1 revision imported

2022-11-18T09:38:31Z

1 revision imported

1>Admin at 12:46, 16 September 2022

2022-09-16T12:46:21Z

Admin: 1 revision imported

2021-02-07T06:52:12Z

1 revision imported

Admin at 19:40, 2 March 2019

2019-03-02T19:40:07Z

New page

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

== Синтаксис ==
<code>
'''OnMark'''(''<Элемент>'',''<Пометка (INT)>'',{{ByRef|''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''):<Текст возникшей ошибки (STRING)>
</code>
==== Аргументы ====
* <code>''<Элемент>''</code> - Элемент справочника или документ, для которого производится попытка удаления (отмены удаления).
* <code>''<Пометка (INT)>''</code> - Ноль, если производится отмена удаления, единица, если производится удаление.
* <code>''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''</code> - {{ByRef}} При нулевом значении этого аргумента, действие будет остановлено без вывода текста ошибки.
==== Возвращаемое значение ====
Функция должна возвратить пустое значение (или пустую строку) для того, чтобы разрешить удаление (отмену удаления) объекта. Для создания исключения результат функции должен содержать текст сообщения о причине невозможности выполнить действие.

== Примеры ==
<pre>
Function OnMark(Element,Mark,ByRef AllowAction)
AllowAction:=1;
If pos("DB.JOURNAL.",typestr(Element))=1 Then
//Для элементов жерналов, найдем реальный элемент справочника/документ
Element:=Element.LinkedObject();
EndIf;
If DBTypeStr(Element)<>"REF" Then
Exit;
EndIf;
If (Mark=1)And((Element.DBName()="Контрагенты")Or(Element.DBName()="Договоры"))And(not Пользователь.КредитныйКонтролер) Then
//Запретить удаление элементов справочников Контрагенты и Договоры без требуемых прав.
Box("Чтобы отменить удаление этого клиента обратитесь к кредитному контролеру!",Q_STOP);
AllowAction:=0;
Exit;
ElseIf (Mark=1)And(Element.DBName()="Номенклатура") Then
If Element.IsFolder() Then
Box("Нельзя удалять группы этого справочника!",Q_STOP);
AllowAction:=0;
Exit;
EndIf;
EndIf;
EndFunction
</pre>

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

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-'''OnMark'''(''<Элемент>'',''<Пометка (INT)>'',{{ByRef|''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''):<Текст возникшей ошибки (STRING)>
+'''OnMark'''(''<Элемент>'',''<Пометка (INT)>'',{{OptionalByRef|<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}{{Optional|,<Номер элемента при выделении диапазона (INT)>}}):<Текст возникшей ошибки (STRING)>
 </code>
 ==== Аргументы ====
 * <code>''<Элемент>''</code> - Элемент справочника или документ, для которого производится попытка удаления (отмены удаления).
 * <code>''<Пометка (INT)>''</code> - Ноль, если производится отмена удаления, единица, если производится удаление.
-* <code>''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''</code> - {{ByRef}} При нулевом значении этого аргумента, действие будет остановлено без вывода текста ошибки.
+* <code>''<Разрешить действие (INT,OUT)>{{Default|{{eq}}1}}}}''</code> - {{Optional}} {{ByRef}} При нулевом значении этого аргумента, действие будет остановлено без вывода текста ошибки.
 ==== Возвращаемое значение ====
 Функция должна возвратить пустое значение (или пустую строку) для того, чтобы разрешить удаление (отмену удаления) объекта. Для создания исключения результат функции должен содержать текст сообщения о причине невозможности выполнить действие.
@@ Line 29: / Line 30: @@
 == Примеры ==
 <pre>
-Function OnMark(Element,Mark,ByRef AllowAction)
+Function OnMark(Element,Mark,ByRef AllowAction,DelIndex)
    AllowAction:=1;
    If pos("DB.JOURNAL.",typestr(Element))=1 Then

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