Form.Destroy - Revision history

Admin: 1 revision imported

2021-04-16T14:17:37Z

1 revision imported

1>Admin at 10:11, 23 March 2021

2021-03-23T10:11:23Z

Admin: 1 revision imported

2021-02-07T06:50:48Z

1 revision imported

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

2020-05-21T13:47:11Z

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

New page

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

== Синтаксис ==
<code>
{{Grey|Form.}}'''Destroy'''({{Optional|<Задавать вопрос о сохранении данных (INT)>{{Default|{{Eq}}1}},<Запретить автоматическое сохранение настроек формы (INT)>{{Default|{{Eq}}0}}}}):''<Закрытие разрешено, форма закрывается (INT)>''
</code>

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

==== Возвращаемое значение ====
Возвращает 1, если форма будет закрыта, иначе возвращает 0 (к примеру, пользователь отказался от закрытия формы).

== Примеры ==
<pre>
//Пример фрагмента модуля печатной формы, имеющей визуальную форму. После нажатия "Печать", форма создает электронную таблицу
// и закрывает визуальную форму с тем, чтобы полностью вернуть управление вызвавшей форме (к примеру, документу)
Function OnExecute()
ВыполнитьПечать();
Form.Destroy(0);
EndFunction
</pre>

← Older revision	Revision as of 14:17, 16 April 2021
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Форма]]}}
-Функция выполняет закрытие текущей формы. Если форма имеет флаг изменения, будет задан вопрос о целесообразности закрытия формы без сохранения данных (вопрос можно отключить). Также можно запретить автоматическое сохранение настроек формы, если таковое предусмотрено установками формы. Пользователь может отказать в закрытии формы, либо обработчики событий, типа [[Студия/Визуальные события|''OnClose'']] могут отменить попытку закрытия. В случае, если форму не удалось закрыть, функция возвращает 0, иначе 1. В случае успешного выполнения функции, форма не будет закрыта до тех пор, пока текущий код не закончит исполнение, так как внутри кода могут быть другие вызовы к элементам и свойствам формы. Если код не возвращает управление слишком долгое время, система производит отмены закрытия формы, форма закрыта не будет. Из-за такого механизма защиты, рекомендуется после вызова функции закрытия сразу же выйти из исполняемого модуля. В отличии от функции [[Form.Close|Close]], данная функция также переносит все простые дочерние формы (таблицы, текстовые формы и пр.) в подчинение родительской формы, если таковая существует. Это позволяет закрыть модальный модуль текущей формы и перейти к исполнению формы-родителя. См. описание [[Форма]].
+Функция выполняет закрытие текущей формы. Если форма имеет флаг изменения, будет задан вопрос о целесообразности закрытия формы без сохранения данных (вопрос можно отключить). Также можно запретить автоматическое сохранение настроек формы, если таковое предусмотрено установками формы. Пользователь может отказать в закрытии формы, либо обработчики событий, типа [[Студия/Визуальные события|''OnClose'']] могут отменить попытку закрытия. В случае, если форму не удалось закрыть, функция возвращает 0, иначе 1. В случае успешного выполнения функции, форма не будет закрыта до тех пор, пока текущий код не закончит исполнение, так как внутри кода могут быть другие вызовы к элементам и свойствам формы. Если код не возвращает управление слишком долгое время, система производит отмену закрытия формы, форма закрыта не будет. Из-за такого механизма защиты, рекомендуется после вызова функции закрытия сразу же выйти из исполняемого модуля. В отличии от функции [[Form.Close|Close]], данная функция также переносит все простые дочерние формы (таблицы, текстовые формы и пр.) в подчинение родительской формы, если таковая существует. Это позволяет закрыть модальный модуль текущей формы и перейти к исполнению формы-родителя. См. описание [[Форма]].
 == Синтаксис ==
@@ Line 21: / Line 21: @@
 ==== Аргументы ====
-* <code>''<Задавать вопрос о сохранении данных (INT)>''</code> - {{Optional}} По умолчанию (1), если форма имеет флаг изменения, пользователю будет задан вопрос о целесообразности закрытия формы без ее сохранения. Если задать этот параметр, как 1, вопрос задан не будет, и форма возможные изменения будут утеряны.
+* <code>''<Задавать вопрос о сохранении данных (INT)>''</code> - {{Optional}} По умолчанию (1), если форма имеет флаг изменения, пользователю будет задан вопрос о целесообразности закрытия формы без ее сохранения. Если задать этот параметр как 0, вопрос задан не будет, и возможные изменения на форме будут утеряны.
 * <code>''<Запретить автоматическое сохранение настроек формы (INT)>''</code> - {{Optional}} Аргумент может запретить автоматическое сохранение настроек формы во время ее закрытия, по умолчанию (0), однако, это сохранение разрешено, если установки формы его позволяют.

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