Admin: 1 revision imported

2021-02-07T06:51:51Z

1 revision imported

Admin at 09:42, 5 June 2019

2019-06-05T09:42:00Z

New page

{{infobox function
|name=ModuleTag
|object=[[Функции общего назначения]]
|caption=Системные функции
|type=1
|status=2
|db=0
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция получает или изменяет свободную переменную, привязанную к текущему (исполняемому) модулю. Значение может использоваться по усмотрению разработчика. Функция может использоваться для хранения значений, когда модуль может быть вызван с формой или без формы. К примеру, если форма, создавшая электронную таблицу, была закрыта пользователем, модуль остается в памяти до тех пор, пока таблица не будет закрыта. Если в таблице присутствуют интерактивные элементы (кнопки, поля и пр.), они будут вызывать соответствующие функции событий из модуля. Однако, зачастую, при формировании таблицы используется некий набор параметров, без которых выполнение некоторых событий не будет возможно (требуются фильтры оригинальной формы или период формирования и пр.). Чтобы обойти эту проблему, можно хранить нужные параметры непосредственно в созданной таблице, а можно в переменной, привязанной к модулю. При начале выполнения любого модуля, функция ''ModuleTag'' возвращает пустое значение. Важно также понимать, что в функциях глобальных модулей, доступ будет осуществляться по-прежнему к значению, привязанному в активному модулю текущего потока, а не глобальному модулю, в котором располагается вызываемая функция.

== Синтаксис ==
<code>
'''ModuleTag'''({{Optional|<Новое значение>}}):''<Предыдущее значение>''
</code>
==== Аргументы ====
* <code>''<Новое значение>''</code> - {{Optional}} изменяет значение, привязанное к текущему модулю.
==== Возвращаемое значение ====
Возвращает текущее (предыдущее) значение, привязанное к текущему модулю.

== Примеры ==
<pre>
//Функции позволяют сохранять или получать произвольные значения, привязанные к текущему модулю, по их имени.
Function СохранитьВМодуле(Имя,Значение)
aList:=ModuleTag;
if TypeStr(aList)<>"LIST" Then
aList:=List.Create();
ModuleTag(aList);
EndIf;
aList.SetByName(Имя,Значение);
EndFunction

Function ПолучитьИзМодуля(Имя)
aList:=ModuleTag;
if TypeStr(aList)<>"LIST" Then
Exit;
EndIf;
Exit aList.GetByName(Имя);
EndFunction
</pre>

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

ModuleTag - Revision history

Admin: 1 revision imported

Admin at 09:42, 5 June 2019