Admin: 1 revision imported

2021-02-07T06:54:33Z

1 revision imported

Admin at 10:08, 26 January 2021

2021-01-26T10:08:39Z

New page

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

Если таблица формируется из потока, модуля или функции, не отображаемых на экране в виде формы, либо текущая форма вызывает другую, с тем, чтобы последняя вывела таблицу на экран и закрылась после вывода, эта функция может закрепить выведенную таблицу за верхней родительской формой, вместо текущей, это позволит избежать ситуации запрета исполнения родительской формы до тех пор, пока не будут закрыты все печатные формы, созданные подчиненной. См. также [[Форма]].

Если таблица формируется из потока не имеющего родительских форм либо вообще не имеющего форм, таблица будет подчинена корневому потоку (будет открыта, как если бы пользователь загрузил в клиенте файл таблицы с диска).

== Синтаксис ==
<code>
{{Grey|Table.}}'''ShowOnParent'''({{Optional|<Заголовок формы с таблицей (STRING)>,<Наименования файла по умолчанию при сохранении таблицы (STRING)>,<Выводить окно на передний план (INT)>{{Default|{{Eq}}1}}}})
</code>

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

== Примеры ==
<pre>
//Модуль был вызван из другой формы с тем, чтобы он вывел отчет
//Если в функции OnOpen вывести таблицу с помощью обычной функции .Show(), модуль не закроется и будет оставаться в памяти
// до тех пор, пока пользователь не закроет таблицу (программа предполагает, что в модуле могут находиться функции, вызываемые из таблицы)
//Использование ShowOnParent исключает эту неудобную ситуацию.
Function OnOpen()
//Закрыть модуль после вывода таблицы
Result:=0;

...

Т:=Table.Create();
Т.SetSourceName("Отчет");
пЗагол:="Отчет по ценам номенклатуры";
Т.CopyByX("v1",1);
Т.Options.FixedLine:=Т.Height();

While З.Next(1) Do
пН:=З.зН;
пКод:=пН.Code;
пЦ:=глНайтиЦену(З.зН,спТипыЦен.Get(i),ДатаФормирования);
Т.CopyByX("v2",1);
EndDo;
Т.CopyByX("v4",1);

Т.Printing.Orientation:=1;
Т.EditorMode:=1;
Т.ShowOnParent(пЗагол,"Prices.xls");
EndFunction
</pre>

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

Table.ShowOnParent - Revision history

Admin: 1 revision imported

Admin at 10:08, 26 January 2021