Form.ControlsToString
| ControlsToString (Работа с установками формы) | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
Функция применяется к загруженной визуальной форме и получает строку со всеми ее установками (либо установками определенных элементов). Сбор информации на форме происходит по правилам, которые работают для обычного сохранения и загрузки установок, поэтому определенные элементы формы могут быть пропущены (элементы для которых установлен признак "не сохранять состояние в установках формы", таблицы, привязанные к базе данных и пр.). Созданная строка-результат имеет формат ANSI и может быть сохранена в виде текста во внешних источниках, однако, элементы базы данных содержатся в ней в виде внутренних кодов, поэтому, загрузка в другую базу данных приведет к позиционированию на неверных элементах. Аргумент может содержать наименования элементов для создания настройки через запятую, если аргумент не задан, будут использованы все элементы формы.
Синтаксис
Form.ControlsToString(<Наименование элементов для создания настройки (STRING)>):<Строка с установками формы (STRING)>
Аргументы
<Наименование элементов для создания настройки (STRING)>- (необязательный аргумент) Задает наименования визуальных элементов, установки которых необходимо сохранить. Наименования должны разделяться запятыми, проблемы после запятых употреблять нельзя. Если аргумент опущен, установки будут сохранены для всех подходящих визуальных элементов. Если какие-либо из наименований не будут найдены, они будут пропущены.
Возвращаемое значение
Возвращает строковое значение в формате ANSI.
Примеры
//Вызов другой формы с установками текущей (формы имеют одинаковые визуальные элементы)
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;
