Admin: 1 revision imported

2021-02-07T06:50:57Z

1 revision imported

Admin: Created page with "{{infobox function |name=SwitchToForm |object=Форма |caption=Сменить текущую форму |type=1 |status=2 |db=0 |exception=Невозможно прев..."

2020-05-19T15:14:20Z

Created page with "{{infobox function |name=SwitchToForm |object=Форма |caption=Сменить текущую форму |type=1 |status=2 |db=0 |exception=Невозможно прев..."

New page

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

== Синтаксис ==
<code>
{{Grey|Form.}}'''SwitchToForm'''(''<Наименование формы (STRING)>''{{Optional|,<Не загружать данные текущей формы в новую форму (INT)>{{Default|{{Eq}}0}}}})
</code>

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

==== Возвращаемое значение ====
Возвращает объект дочерней формы.

== Примеры ==
<pre>
//Пример функции, которая меняет форму документа в момент, когда пользователь выбирает другой код операции.
Function ПослеИзмененияКодаОперацииВДокументе()
aEl:=Form.Object;
пИмя:="Form";
If (aEl.КодОперации=Enum.коРегистрацияОС.СписаниеОСКомиссия)Or(aEl.КодОперации=Enum.коРегистрацияОС.СписаниеОС)Or(aEl.КодОперации=Enum.коРегистрацияОС.ВводВЭксплуатациюИСписаниеОС)
Or(aEl.КодОперации=Enum.коРегистрацияОС.РеализацияОС)Or(aEl.КодОперации=Enum.коРегистрацияОС.ВводВЭксплуатациюОС) Then
пИмя:="FormСписание";
ElseIf aEl.КодОперации=Enum.коРегистрацияОС.ИнвентаризацияОС Then
пИмя:="FormИнвентаризация";
ElseIf aEl.КодОперации=Enum.коРегистрацияОС.ПеремещениеОС Then
пИмя:="FormПеремещение";
EndIf;

If Uppercase(пИмя)<>Uppercase(RemoveExt(GetFileName(Form.GetFormFileName()))) then
Form.SwitchToForm(пИмя);
EndIf;
EndFunction
</pre>

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

Form.SwitchToForm - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=SwitchToForm |object=Форма |caption=Сменить текущую форму |type=1 |status=2 |db=0 |exception=Невозможно прев..."