Admin: 1 revision imported

2021-02-07T06:50:48Z

1 revision imported

Admin at 17:30, 8 June 2020

2020-06-08T17:30:00Z

New page

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

== Синтаксис ==
<code>
{{Grey|Form.}}'''ControlsToString'''({{Optional|<Наименование элементов для создания настройки (STRING)>}}):''<Строка с установками формы (STRING)>''
</code>

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

==== Возвращаемое значение ====
Возвращает строковое значение в формате ANSI.

== Примеры ==
<pre>
//Вызов другой формы с установками текущей (формы имеют одинаковые визуальные элементы)
aList:=Param.Copy();
aList.Add(Form.ControlsToString(),"Установки");
LoadModule(0,"Modules\FreeForms\ПечатныеФормы\Документ.Реализация\ТН",aList,0,"Module","Form");

...

//В обработчике OnOpen вызываемой формы указывается:
If _And(TypeStr(Param)="LIST",not isEmpty(Param.GetByName("Установки"))) Then
Form.ControlsFromString(Param.GetByName("Установки"));
EndIf;
</pre>

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

Form.ControlsToString - Revision history

Admin: 1 revision imported

Admin at 17:30, 8 June 2020